目录

  • 一、序言
  • 二、构建工具配置
  • 1、Vite打包配置
  • 2、Vue CLI打包配置
  • 三、Vue-Router配置
  • 四、Nginx配置


一、序言

生产环境中Vue项目我们一般会部署在域名的子目录下，在了解如何部署时我们先了解下Vue构建相关的基础知识。

首先Vue项目打包后其实就是个单页应用，这也是为什么第一次加载时会比较慢。

既然是单页应用，如果想在Nginx中指定前缀访问静态资源和文件，需要在打包构建时配置base路径，目前Vue使用的构建工具有Vite(针对Vue3)还有Vue CLI(基于Webpack，针对Vue2)。

同时Vue-Router实例化时如果历史记录模式为HTML5模式，也需要指定路由的base路径，不然资源会访问失败。

二、构建工具配置

1、Vite打包配置

Vite目前是Vu3主流构建工具，打包配置我们可以在vite.config.js中进行修改，指定base配置即可，这里我们指定了base为/easy-wealth/，也就是说所有的静态资源都会带上该前缀。

import {defineConfig} from 'vite';
import vue from '@vitejs/plugin-vue';
import legacy from '@vitejs/plugin-legacy';
import path from 'path';

// https://vitejs.dev/config/
export default defineConfig({
    base: '/easy-wealth/',
    plugins: [
        vue(),
        legacy({
            targets: ['defaults', 'not IE 11'],
        })
    ],
    resolve: {
        alias: {
            '@': path.resolve(__dirname, './src')
        }
    }
});

2、Vue CLI打包配置

Vue CLI目前已经处于维护状态，一般老项目可能还在用它来开发，Vue CLI打包时基于Webpack构建。通过vue.config.js我们可以通过publicPath选项指定静态资源的访问前缀，配置如下：

module.exports = {
  publicPath: '/easy-wealth/',
  outputDir: 'dist',
  assetsDir: 'static',
  lintOnSave: process.env.NODE_ENV !== 'production'
 }

通过上述配置，打包后我们会发现index.html文件里所有的静态资源访问路径前都加上了/easy-wealth前缀。

nginx配置 多个 vue2项目_nginx

三、Vue-Router配置

目前Vue-Router支持3种历史记录模式，分别是Hash模式、Memory模式和HTML5模式。如果我们指定历史记录模式为HTML5模式，那么一定要指定路由的base路径，不然页面访问会出现404。

const router = createRouter({
    history: createWebHistory('/easy-wealth/'),
    routes
});

export default router;

四、Nginx配置

在Nginx配置中，我们加了一项try_files回退路由配置，前面已经说过Vue项目是单页面应用，这项配置看起来有点复杂，但也容易理解，举个例子：

当访问http://test.com/easy-wealth/hwc时，Nginx首先会去h5/easy-wealth/dist目录下找名为hwc的目录，以及该目录下的文件，如果都没有找到，则回退访问/easy-wealth/index.html，这时Nginx会在h5/easy-wealth/dist下找到名为index.html的文件。

location /easy-wealth {
   alias h5/easy-wealth/dist;
   try_files $uri $uri/ /easy-wealth/index.html;
}