当前位置:   article > 正文

用Gitee Pages服务在线预览vue3前端项目:静态网站+多级路由+history模式(踩坑)_gitee 上的项目如何预览

gitee 上的项目如何预览

目录

目标与前提

vue打包、预览遇到的坑以及原因

坑①:静态网站打开一片空白

坑②:子路由刷新或直接输入时,网页一片空白或404

坑③:首页加载时间过长

坑④:线上预览地址出错时,不显示404页面

坑⑤:线上更新页面文件以后,访问网址发现内容没变

实现预览+解决问题(省略vue和git基础)

1、Gitee账号实名认证

2、解决坑①以及本地调式时遇到的坑②

3、解决坑③-使用路由懒加载

4、解决坑④-给前端路由设置404页面

5、解决部署dist静态网站时遇到的坑②:创建spa文件

6、打包vue项目、更新到gitee远程库

7、使用Gitee Pages部署静态网站

8、解决坑⑤-手动更新+清除缓存+URL跟随机数


        多个开源平台都支持项目在线预览,比如github、gitee,考虑国内访问速度、中文支持以及免费,使用gitee。

目标与前提

前提:vue3的前端demo,包括多级路由(子路由),router用的是history模式,已通过Gitee进行版本管理。

目标:不改变以上前提,用Gitee Pages实现该demo在线展示

vue打包、预览遇到的坑以及原因

坑①:静态网站打开一片空白

            原因:首次打包vue项目遇到这个问题,九成是静态文件路径错误。

坑②:子路由刷新或直接输入时网页一片空白或404

            原因:history模式下地址栏没有#符号,url比hash模式好看,对SEO排名也有益处。但直接输入地址或刷新页面时,浏览器会将URL整个发到后端,后端找URL下的index.htm,文件不存在,返回404。

坑②分两种情况,一种是本地调试时遇到的,一种是部署dist静态网站时遇到的,两者解决方法有分别,详述见下文。

坑③:首页加载时间过长

            原因:排除网络、图片懒加载因素,如果还是加载时间过长,可能是路由没有用懒加载,加载首页的时候其他路由被同时加载。

坑④:线上预览地址出错时,不显示404页面

            原因:如果这个问题是解决坑②以后出现,此时网站目录下的网址是前端路由在处理,所以后端不会发404页面给前端,而前端路由也没有设置404页面,所以一片空白。

坑⑤:线上更新页面文件以后访问网址发现内容没变

            原因:1、Gitee免费版不会主动更新网页文件;2、浏览器缓存未清除。

实现预览+解决问题(省略vue和git基础)

1、Gitee账号实名认证

        Gitee账号要实名认证,才能使用Gitee Pages,可以先提交照片到认证页面,然后处理接下来的工作,因为认证大概需要一个工作日。

2、解决坑①以及本地调式时遇到的坑②

        打包之前先要填几个坑,需要配置vue.config.js文件,没有就在项目根目录下新建一个,内容如下,其中publicPath设置成 /gitee远程库名/ ,两边是斜杠:

  1. module.exports = {
  2. publicPath: '/effects/', //gitee远程库名
  3. //比如:pages地址:https://xxxxxx.gitee.io/effects,publicPath就是/effects/
  4. outputDir: 'dist/',
  5. assetsDir: 'static/'
  6. }

3、解决坑③-使用路由懒加载

        在router/index.js文件中,将引用页面的语句改成以下方式:

const Home=() => import("@/views/Home.vue")

        上边代码中的常量Home,被调用时才会将页面引用进来。多个路由修改成懒加载示例:

  1. //懒加载
  2. const [Home,Child]=[
  3. () => import("@/views/Home.vue"),
  4. () => import("@/views/Child.vue"),
  5. ];
  6. const routes = [{
  7. path: '/',
  8. name: 'Home',
  9. component:Home,
  10. children:[{
  11. path: 'Child',
  12. name: 'Child',
  13. component:Child,
  14. }]}];

        注意事项:
                1)旧项目中,如果使用babel,以上语句可能引发报错,此时需要安装syntax- dynamic import中间件:

npm install --save-dev @babel/plugin-syntax-dynamic-import

                2)如果脚手架已经升级,例如CLI5.0.4版本,就不需要安装1)中的插件了。新项目默认使用懒加载。只是引用没有定义成常量,如果需要复用,可以自己定义一下。

4、解决坑④-给前端路由设置404页面

        建立src/views/NotFound.vue文件,内容如下(按需改):

  1. <template>
  2. <div>{{"页面不存在"+s+"秒以后为您跳转至主页"}}</div>
  3. </template>
  4. <script>
  5. export default {
  6. data(){return{s:3,}},
  7. mounted(){
  8. let timer=setInterval(()=>{
  9. this.s-=1;
  10. if(this.s<=0){
  11. clearInterval(timer);
  12. console.log(this.s);
  13. this.$router.push({name:'Home'});
  14. }},1000);
  15. }}
  16. </script>

        在router/index.js文件中设置404路由,/:pathMatch(.*)/放在最后一项:

  1. //懒加载
  2. const [Home,Child,NotFound]=[
  3. () => import("@/views/Home.vue"),
  4. () => import("@/views/NotFound.vue") //404页面引入
  5. ];
  6. const routes = [
  7. {
  8. path: '/',
  9. alias:'/Home',
  10. name: 'Home',
  11. component:Home,
  12. },
  13. //404页面设置↓================================
  14. {
  15. path:'/404',
  16. name:'404',
  17. component:NotFound,
  18. },
  19. {//放到路由最下边一项,因为路由会先匹配上边的项
  20. path:'/:pathMatch(.*)/',
  21. name:'NotFound',
  22. redirect:'404',
  23. }
  24. //404页面设置↑================================
  25. ];

5、解决部署dist静态网站时遇到的坑②:创建spa文件

        参考Gitee Pages文档:只要在dist文件夹下加一个.spa文件即可,spa前边有个点,点前边什么也不写,文件内容也不用写,就是给Gitee Pages一个记号,有这个记号的文件夹会被看做单页面应用。
Pages 单页面应用支持 - Gitee.com

6、打包vue项目、更新到gitee远程库

        cmd项目根目录下执行以下命令:

npm run build

        打包以后,项目根目录会生成dist文件夹,就是静态网站的根目录。

   注意:先检查项目根目录下的.gitignore文件,如果有dist这一项,就将该项删掉,不然dist文件夹无法添加到库。

        将打包好的项目更新到gitee远程库,此时在远程库中应看到dist文件夹。

7、使用Gitee Pages部署静态网站

        实名认证成功以后,在gitee远程库的服务菜单中选择Gitee Pages→选择要部署的分支(默认master)→部署目录填写dist→勾选“强制使用HTTPS”→开启→点击网站地址即可预览。

8、解决坑⑤-手动更新+清除缓存+URL跟随机数

        1)Gitee免费版不自动更新,需要手动在Gitee Pages 服务页面(上图),点击更新;
        2)可以手动清除浏览器缓存,以google为例,按下ctrl+shift+del,在“清除浏览数据”中选择“缓存的图片和文件”→点击清除数据,再进入网站就会重新加载页面了。

        3)但是他人浏览网站时,不能指望对方主动清除缓存,可以通过添加meta的方式解决:

  1. <meta http-equiv="pragram" content="no-cache">
  2. <meta http-equiv="cache-control" content="no-cache, must-revalidate">

        除了添加meta之外,还可以让URL带一串随机参数,例如:

https://abcd.io/exp?16499455593433257


        参数可以用时间截+随机数字生成,例如:

  1. let url =
  2. "https://abcd.io/exp" +
  3. "?" +
  4. new Date().getTime().toString() +
  5. (Math.random() * 9999).toFixed(0).toString();

        浏览器会重新请求页面,但是原来的缓存还在浏览器,直到缓存过期。

  • 如果更新的是主页,需要更新公布出去的网址,改变URL随机参数。
  • 如果更新的是子页面,可以在路由或主页中的子页面连接中提前设置随机数。
声明:本文内容由网友自发贡献,转载请注明出处:【wpsshop博客】
推荐阅读
相关标签
  

闽ICP备14008679号