Vue项目打包部署到GitHub Pages的实现步骤
作者:mingyong.g
前言
关于什么是github pages
?怎样创建github 仓库
上传本地项目到GitHub远程仓库?等基本操作本文不再赘述,初学者可以通过搜索找到大量文章教程。本文重点在于:
如何将vue项目源码(含dist目录)同步到到github仓库,同时单独将项目下的dist目录同步到
gh-pages
分支以便使用GitHub pages 发布和预览静态网页。
针对以上问题,作者以往的做法是将Vue项目源码托管到源码仓库,然后另外创建一个webpage仓库管理dist
目录。然后针对webpage
仓库开启GitHub pages 功能。实现GitHub pages访问Vue生成的静态页面
上述操作适用于不想公开源码仓库,同时又想免费使用GitHub pages
服务的情形,通常情况下一些个人的demo项目或是开源项目等仓库本身就是公开的,使用上述方法同时需要管理两个仓库,操作麻烦,最近了解到可以使用git subtree push --prefix dist origin gh-pages
指令将项目下dist
目录单独推送到远程仓库的gh-pages
分支然后再将GitHub pages的source切换到gh-pages
分支即可使用GitHub pages
服务,到master
分支管理源码gh-pages
分支部署GitHub pages
的目的
前期准备
- 编译调试通过的Vue项目
- 将本地项目推送到
Github远程仓库
默认master分支
步骤1和步骤2这方面的文章和教程不要太多,此处略过
重要说明
关于Vue项目的publicPath
- 如果你打算发布到 https://.github.io/,则可以省略这一步,因为 publicPath默认即是 “/”。
- 如果你打算发布到 https://.github.io/
<REPO>
/(也就是说你的仓库在 https://github.com/<USERNAME>
/<REPO>
),则将 publicPath 设置为 “/<REPO>
/”。
<PERO>
即你的仓库名称
步骤1
执行npm run build
打包Vue项目,此时项目目录下会多出一个dist
目录
步骤2
将dist推送到远程仓库(默认为master分支)
通常dist目录会被git忽略,需要将dist从忽略文件中删除,然后将dist目录推送到远程仓库
步骤3
🚨 使用git subtree push --prefix dist origin gh-pages
将dist
目录推送到远程的gh-pages
分支,若远程没有gh-pagse
分支则会新建gh-pagse
分支然后再推送。
备注:此处只能是gh-pages
分支,才能使用GitHub pages
功能
步骤4
登录远程GitHub仓库,通过setting
-> github pages
-> source
将gh-pages
设置为GitHub pages
的source
步骤5
访问GitHub pages 链接
步骤6
每次执行npm run build
后再次执行步骤2,步骤3
到此这篇关于Vue项目打包部署到GitHub Pages的实现步骤的文章就介绍到这了,更多相关Vue打包部署到GitHub Pages内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!