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

在这里插入图片描述

评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Nick说说前后端

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值