Vue项目打包部署总结，2024年最新程序员必学的书籍

只需要添加一条location规则，分配访问路径和指定访问文件夹。我们可以把/test指向之前创建的/www文件夹，这里因为文件夹名称和访问路径不一致，需要用到alias这个配置：

Vue项目打包发布问题汇总

如果文件夹名称与访问路径一致都为test，那这里可以用root来配置：

Vue项目打包发布问题汇总

这里要将/test配置放到/之前，意味着在路由进入的时候，会优先匹配/test。如果根路径/下的项目有子路由/test，那http://xxxx/test只会访问到/www里的项目，而不会访问该子路由。

2. 项目配置

为了解决打包后资源路径不对的问题，需要在vue.config.js中配置publicPath，这里有两种配置方式，分别将publicPath配置为./和/test：

Vue项目打包发布问题汇总

更新nginx配置，发布后即可正常访问啦。这里的两种配置方式是有区别的，接下来会看一下它们的区别。如果不进行项目配置，直接发布访问会出现JS、CSS等资源找不到导致页面空白的问题：

Vue项目打包发布问题汇总

该问题原因是资源引用路径不对，页面审查元素可以看到，页面引用的js都是从根路径下引用的：

Vue项目打包发布问题汇总

查看打包后的文件结构，可以看到js/css/img/static等资源文件是与index.html处于同级别的：

Vue项目打包发布问题汇总

对于两种配置方式，看看都是怎么生效的：

1. publicPath配置为./， 打包后资源引用路径为相对路径：

2. publicPath配置为/test，打包后资源相对路径为从域名根目录开始的绝对路径：

两种配置都可以正确地找到JS、CSS等资源。不过还有个问题，那就是static中的静态资源依旧会找不到。

3. 绝对路径引用的静态资源找不到的问题

因为在打包过程中，public下的静态资源都不会被webpack处理，我们需要通过绝对路径来引用它们。当项目部署到非域名根路径上时，这点非常头疼，你需要在每个引用的URL前面加上process.env.BASE_URL（该值即对应上文配置的publicPath），以使得资源能被正常访问到。我们可以在main.js把这个变量值绑定到Vue.prototype，这样每个Vue组件都可以使用它：

Vue.prototype.$pb = process.env.BASE_URL

在模板中使用：

然而，更加头疼并且没有良好解决方案的问题是在组件style部分使用public文件夹下的静态资源：

• 如果需要使用图片等作为背景图片等，尽量使用内联方式使用吧，像在模板中使用一样。

• 如果需要引入样式文件，则在index.html中使用插值方式引入吧。

关于静态资源的问题，vue-cli的推荐是尽量**将资源作为你的模块依赖图的一部分导入（即放到assets中，使用相对路径引用），**避免该问题的同时也带来其它好处：

四、history模式部署

---

默认情况下，Vue项目使用的是hash路由模式，就是URL中会包含一个#号的这种形式。#号以及之后的内容是路由地址的hash部分。正常情况下，当浏览器地址栏地址改变，浏览器会重新加载页面，而如果是hash部分修改的话，则不会，这就是前端路由的原理，允许根据不同的路由页面局部更新而不刷新整个页面。H5新增了history的pushState接口，也允许前端操作改变路由地址但是不触发页面刷新，history模式即利用这一接口来实现。因此使用history模式可以去掉路由中的#号。

1. 项目配置

在vue-router路由选项中配置mode选项和base选项，mode配置为’history’；如果部署到非域名根目录，还需要配置base选项为前文配置的publicPath值（注意：此情况下，publicPath必须使用绝对路径/test的配置形式，而不能用相对路径./）

Vue项目打包发布问题汇总

2. nginx配置

对于history模式，假设项目部署到域名下的/test目录，访问http://xxx/test/about的时候，服务器会去找/test指向的目录下的about子目录或文件，很显然因为是单页面应用，并不会存在a这个目录或者文件，就会导致404错误：

Vue项目部署后页面找不到

我们要配置nginx让这种情况下，服务器能够返回单页应用的index.html，然后剩下的路由解析的事情就交给前端来完成即可。

history模式nginx配置

这句配置的意思就是，拿到一个地址，先根据地址尝试找对应文件，找不到再试探地址对应的文件夹，再找不到就返回/test/index.html。再次打开刚才的about地址，刷新页面也不会404啦：

Vue项目打包发布问题汇总

3. history模式部署到非域名根路径下

非域名根目录下部署，首先肯定要配置publicPath。需要注意的点前面其实已经提过了，就是这种情况下不能使用相对路径./或者空串配置publicPath。为什么呢？原因是它会导致router-link等的表现错乱，使用测试项目[2]分别使用两种配置打包发布，审查元素就能看出区别。在页面上有两个router-link，Home和About：

Vue项目打包发布问题汇总

两种配置打包后的结果如下。

1. publicPath配置为./或者空串：

2. publicPath配置为/test：

publicPath配置为相对路径的router-link打包后地址变成了相对根域名下地址，很明显是错误的，所以非域名根路径部署应该将publicPath配置为完整的前缀路径。

五、结语

---

关于Vue项目发布的相关问题就先总结这么多，几乎在每一步都踩过坑才有所体会，有问题欢迎各位同学一起探讨。写博客很累，不过收获也很多，还是要坚持；有时候别人转载自己的原创文章也不标明出处，竟然将写文章日期改得比原创还早，有点心累。本文中使用到的图片都加了个自己的水印，是前端实现的，原理也很简单，之后写一篇简短的文章分享一下。

参考资料

[1]

Vue项目打包发布: https://github.com/Lushenggang/vue-publish-test

[2]

Vue项目打包部署测试项目地址: https://github.com/Lushenggang/vue-publish-test

相关文章

---

1. 基于Vue的前端架构，我做了这15点

2. Vue3的学习记录

3. 一份很棒的Vue3 学习清单

最后

–

转发文章并关注公众号：前端开发博客，回复 1024，领取前端进阶资料

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数前端工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Web前端开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上前端开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录大纲截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且后续会持续更新

如果你觉得这些内容对你有帮助，可以添加V获取：vip1024c （备注前端）

打开全栈工匠技能包-1小时轻松掌握SSR

两小时精通jq+bs插件开发

生产环境下如歌部署Node.js

网易内部VUE自定义插件库NPM集成

谁说前端不用懂安全，XSS跨站脚本的危害

webpack的loader到底是什么样的？两小时带你写一个自己loader

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！

e/format,png)

webpack的loader到底是什么样的？两小时带你写一个自己loader

一个人可以走的很快，但一群人才能走的更远。不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人，都欢迎扫码加入我们的的圈子（技术交流、学习资源、职场吐槽、大厂内推、面试辅导），让我们一起学习成长！
[外链图片转存中…(img-uC3owSP2-1712718448458)]