history模式下Vue项目如何打包部署?

目录
文章目录隐藏
  1. 前提准备
  2. 部署流程
  3. vue.config.js
  4. vue-router
  5. npm run build
  6. nginx

本教程讲解的是 vue-router 中 history 模式的部署,完全适用于 vue-cli3,4。vue-cli2 需要进行略微改动。

前提准备

我们需要准备一个 vue 项目(vue-cli3 或 vue-cli4)、一个 nginx 服务器。

部署流程

  1. 配置 vue.config.js 中的publicPath
  2. 配置 vue-router 的模式为history
  3. 配置 vue-router 中的base(基态路由【与服务端配合】)
  4. 使用npm run build生成 dist 文件夹
  5. 配置 nginx 代理(进行生产环境下的反向代理,注意生产环境下devServer无效【或者你可以配置devserver的根目录是 dist 都可以】)
  6. 配置 nginx 路由

vue.config.js

如果你的项目中没有这个文件,直接在项目根目录创建它即可。

配置 publicPath

这里我们配置publicPth为路由/vue/

module.exports = {
    // /vue/这个名字你自己起,也可以用我这个
    publicPath: process.env.NODE_ENV === "production" ? "/vue/" : "/",
    outputDir:'dist',
}

注意:为了兼容各种情况,我强烈建议大家路由写成/vue/而不是写成/vue

vue-router

配置路由模式和基础路由

export default new Router({
    // history 模式,需要和服务端配合才能在生产环境下正常使用
    mode: 'history',
    // 基本路由,这个名字可以自己起,但是要注意和 vue.config.js 里面 publicPath 所起的名字一致
	base:'/vue/',
    routes:[]
})

npm run build

我们在 vue 项目根目录下运行npm run build就可以进行项目的打包了。打包后会生成 dist 文件夹,把它放进 nginx 的 html 文件夹下即可。

nginx

1.配置 nginx 代理

有些时候我们需要请求一些跨域服务,在开发时,我们可以配置devServerproxy实现跨域访问。

但是在npm run build后,我们会发现代理无效。这是因为生产环境下的文件已经脱离devServer了,所以自然代理就没有用了,所以一般生产环境代理我们使用 nginx 去做。

location /api/{
    proxy_pass  http://192.136.21.1:6600/;
    index  index.html index.htm;
}

location /info/{
    proxy_pass  https://mybj123.com/;
    index  index.html index.htm;
}

假设我们的nginx服务器的端口号是 8080,那么我们做跨域请求时候只需要访问:localhost:8080/api就行了,这样做我们就相当于访问那个服务器下的资源。

但是一般部署项目的时候我们不会发送 axios 去请求localhost:8080/api,我们会直接请求/api

举个例子:

//不会这样做,因为部署服务器后地址要换成 ip,不然会 404
axios.get("localhost:8080/api")
//你可以选择这样做,但是我们不推荐
axios.get("ip:8080/api")
//我们推荐这样做,让 axios 根据相对路径补全 ip+端口,
//这样比较省心【但是要注意你的项目要部署在 nginx 代理服务器下。
//如果你不部署的话相对路径也是不行的,毕竟你都没部署人家 nginx 服务器上,
//自然你的项目就不是 nginx 家的孩子,所以相对路径的小名,nginx 怎么能认识呢?】
axios.get("/api")

2.配置 nginx 路由

location / {
    root   html;
    index  index.html index.htm;
    autoindex on;       #开启 nginx 目录浏览功能
    autoindex_exact_size off;   #文件大小从 KB 开始显示
    charset utf-8;          #显示中文
}
# 写我们的路由暗号/vue
location /vue{
    # alias 后面写项目所在目录 xxxxxxx 一定要注意,不能写成 D:\nginx\nginx-1.20.0\html\dist,要写成斜杠/形式,否则会 404
    alias D:/nginx/nginx-1.20.0/html/dist;
    charset utf-8;          #显示中文
}

现在启动 nginx 服务器输入localhost:8080/vue就可以访问我们的 vue 项目了。

就是这么简单,你学会了吗?

「点点赞赏,手留余香」

1

给作者打赏,鼓励TA抓紧创作!

微信微信 支付宝支付宝

还没有人赞赏,快来当第一个赞赏的人吧!

声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系maynote@foxmail.com处理
码云笔记 » history模式下Vue项目如何打包部署?

发表回复