Skip to content

配置

配置是开发一个项目的重要环节,它是一个项目的基础。想要了解一个项目,先要了解它的配置。

web前端站点配置

midway-vue3-ssr 内置了一个web前端站点配置文件 /web/config/settings.ts

/**
 * 站点配置
 * @author LiQingSong
 */

/**
 * @description: 站点名称
 */
export const siteTitle = 'MIDWAY-VUE3-SSR';

/**
 * @description: 站点本地存储Token 的 Key值
 */
export const siteTokenKey = 'midway_vue3_ssr_token';

/**
 * @description: Ajax请求头发送Token 的 Key值
 */
export const ajaxHeadersTokenKey = 'x-token';

/**
 * @description: Ajax返回值不参加统一报错的api地址
 */
export const ajaxResponseNoVerifyUrl: string[] = [
  '/user/login', // 用户登录
  '/user/info', // 用户信息
];

/**
 * @description: 平台用户登录的界面Url地址
 */
export const userLoginUrl = '/user/login';


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

web前端路由入口配置

midway-vue3-ssr 独立出了一个前端路由入口配置文件 /web/config/routes.ts,其目的主要是:统一引入/web/layouts下不同layout的路由,集中处理重新格式化路由。

目前 /web/config/routes.ts 的内容为:

import {
  createRouter as _createRouter,
  createMemoryHistory,
  createWebHistory,
  Router,
} from 'vue-router';
import NProgress from 'nprogress'; // progress bar

import DefaultLayoutRoutes from '@/layouts/DefaultLayout/routes';
import DefaultLayout from '@/layouts/DefaultLayout/index.vue';

export const createRouter = (type: RouterType): Router => {
  const router = _createRouter({
    scrollBehavior(/* to, from, savedPosition */) {
      return { top: 0 };
    },
    history: type === 'web' ? createWebHistory() : createMemoryHistory(),
    routes: [
      {
        path: '/',
        name: 'root',
        component: DefaultLayout,
        children: DefaultLayoutRoutes,
      },
    ],
  });

  router.beforeEach((/* to, from */) => {
    if (!import.meta.env.SSR) {
      // start progress bar
      NProgress.start();
    }
  });

  router.afterEach(() => {
    if (!import.meta.env.SSR) {
      // finish progress bar
      NProgress.done();
    }
  });

  return router;
};

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

说明:

详细文档请查看:路由

vite 配置

midway-vue3-ssr web前端是基于 vite 来进行构建,所以有个 vite 配置文件 /web/vite.config.ts

官方文档

web前端环境变量

midway-vue3-ssr web前端是基于 vite 来进行构建,所以有环境变量配置文件 /web/.env.development/web/.env.production

官方文档

midway 多环境配置

midway-vue3-ssr Node.js服务端是基于 Midway 来进行构建,所以有多环境配置配置文件 /src/config/**

官方文档

Released under the MIT License.