Vue项目Nginx子目录部署(Vite和Vue-CLI)

一、序言

生产环境中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前缀。

三、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;
}

到此这篇关于Vue项目Nginx子目录部署(Vite和Vue-CLI)的文章就介绍到这了,更多相关Vue Nginx子目录部署内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！