美文网首页工具集闲汪的vue学习笔记随笔-生活工作点滴
vue项目打包上线的一些坑(持续更新中)

vue项目打包上线的一些坑(持续更新中)

作者: 闲汪 | 来源:发表于2019-07-10 16:07 被阅读125次

    一、打包的命令

    相信同学们对于打包vue-cli项目都不陌生了,简单的执行下面这条语句就行了:

    npm run build

    看看我们的 package.json 文件,它的 scripts 里有这么一句

    "build": "node build/build.js"

    因此,我们可以执行上面的那条命令进行打包,常用的 npm run dev 等等也是同理

    本地打包就这样非常轻松的完成了

    注意,有几个可能你不知道的坑在等着你!!!



    二、Tip: built files are meant to be served over an HTTP server. Opening index.html over file:// won't work.

    看到控制台给出了这样的提示,,很多同学慌了:是不是我打包失败了?

    别紧脏,控制台告诉我们只能够在http服务器下访问我们的index.html,而不能从本地文件中打开,并没有提示我们打包失败!

    想要本地访问我们的项目,只需要在本地启一个测试服务器就好啦,这里推荐一个好用的软件:xampp ,不多介绍,同学们自行查阅安装。

    后台同学已经配好了Jenkins自动构建,我们不需要在本地打包,跳过这一步,直接把源码上传到我们的代码仓库(gitlab)中,等待服务器构建完毕,就能访问啦!

    具体的配置等服务端同学的帖子发了,我再贴给大家!


    二、去除路由中的 #

    我们本地环境开发的时候,默认的访问地址:

    localhost:8080/#/路由

    访问后台同学配置好的域名,看看我们的地址栏:

    服务端配置的地址/#/路由

    想想百度之类的网站,哪有这个,啥玩意,丑!!

    下面我们去掉它

    看我们项目目录里 config 文件夹下的 index.js 文件

    里面 module.export 的有两个配置:dev 和 build,分别代表开发环境和生产环境,我们看生产环境

    // Template for index.html

    index: path.resolve(__dirname, '../dist/index.html'), // index.html

    // Paths

    assetsRoot: path.resolve(__dirname, '../dist'), // 打包输出目录

    assetsSubDirectory:'static', // 静态资源目录

    assetsPublicPath:'./',

    这几句决定了我们的打包路径

    首先我们把 assetsPublicPath 改成绝对路径 ‘/’ 

    再看 src/router/index.js 这个文件,也就是我们常用的路由配置文件

    添加这样一句:

    mode:'history',

    将路由模式改为history,具体介绍看 官方文档 ,这里不多讲。

    网上还有说法,需要在这里添加 base 配置,否则会导致嵌套路由失效,我没加,啥问题也没有,暂时不管。

    好了,前端能做的就只有这么多了,剩下的都是服务端同学的工作了

    什么,不服气?你只是个前端,就算你技术再好......咳咳,扯远了


    三、刷新页面显示404错误

    页面刷新后报404错误,原因其实也很简单

    vue是个单页应用,它的路由是模拟的url,并没有在服务器上真实存在,当然访问不到

    举个栗子🌰

    我们的网址是:www.xxx.com,后端同学会把服务器上的 index.html 映射到这个网址上

    然而,当我们访问登录页,在地址栏输入 www.xxx.com/login 的时候,服务器蒙了,臣妾做不到啊!哪有这个东西,不得已,只好给个404给你

    官网推荐nginx服务器添加如下配置:

    location / {

        try_files $uri $uri/ /index.html;

    }

    意思就是在访问所有请求不到的资源地址的时候,返回我们的index.html

    不知道你们成功没有,反正我们这么搞没成功,但据说也差不多,具体的配置以后再发!!!

    所以如果有问题,去麻烦你的后端同学吧,纯前端真的只能做到二里面的两步,555......


    四、静态资源路径错误

    这个问题网上的解决方案有很多,我也试过很多,有的行有的不行,这里简单给个终级解决方案:

    图片:就上传到静态服务器上,别管相对路径绝对路径的,这样最稳,我们用的是 阿里云OSS

    当然,如果你的页面运行在https而文件路径是http,页面上会有不少警告

    js文件:一般都分布在各个组件里,个人习惯把公共js文件放在 /src/common/js/ 目录下,你也可以放在 /src/assets/js/ 目录下

    第三方插件的js:一定要放在 static 文件夹里,他和assets的区别,简单来说,就在于:static文件夹不会进行二次打包

    然后在index.js里引用这个文件,当然,能用npm安装,尽量还是npm吧

    样式文件,请看我的另一篇文章:vue-cli项目如何使用sass?

    这样做,上线后的资源路径,基本不会有问题


    五、Uncaught SyntaxError: Unexpected token <

    最开始,遇到这个问题,我是一脸懵逼的

    别晃,冷静,我们看控制台,报错地址是我用的第三方插件

    说到底,还是资源路径有问题

    出现这个问题,我们的index.html应该是这么写的:

    <script src="./static/js文件名"></script>

    想想我们第二步最开始做了什么?生产环境下,我们的路径已经修改为绝对路径

    那么做相应的修改,把那个点号去掉

    <script src="/static/js文件名"></script>

    修改成功,看看控制台,不再报错了。


    六、结语

    本来开发开开心心的心情,怎么一到打包就不行了捏,打包这件事儿,肯定还有许多我也没遇到的坑,所以这篇文章也会不定期更新。

    希望这篇文章能够帮助同学们成功爬坑,如果对您有所帮助,请关注、点赞并收藏,有其他问题也可以留言或私信,欢迎讨论!

    相关文章

      网友评论

        本文标题:vue项目打包上线的一些坑(持续更新中)

        本文链接:https://www.haomeiwen.com/subject/bohhkctx.html