如何将Vue项目打包并上传GitHub,实现GitHub Pages预览?

更新于
2026-10-02 09:12:28
1阅读来源:SEO教程
  • 内容介绍
  • 文章标签
  • 相关推荐

本文共计568个文字,预计阅读时间需要3分钟。

在Vue项目中,打包并上传到GitHub并实现GitHub Pages预览:

1. 打包Vue项目:在命令行中输入打包命令 `npm run build`,生成dist文件夹。

2.上传到GitHub:将dist文件夹中的内容上传到GitHub仓库的相应分支。

3.配置GitHub Pages:在GitHub仓库的设置中,选择GitHub Pages,并配置分支为存放dist文件夹的分支。

常见问题及解决方法:

1.项目资源无法加载:检查项目中的资源路径是否正确,确保资源文件已包含在dist文件夹中。

vue项目打包后上传至GitHub,并实现github-pages的预览

1. 打包vue 项目

vue项目:

命令行输入打包命令npm run build,生成了dist文件夹:


打包完成。

打包常见问题1——项目资源无法加载

打开刚刚打包好的dist文件夹,浏览器打开index.html


发现该页面是空白的,打开控制台发现

这里看到index.html文件中没有加载任何css、js文件。

解决方法——修改config文件

打开项目根目录config下的index.js文件,进行如下修改:

即将assetsPublicPath: '/'改成assetsPublicPath: './'

重新npm run build

打包常见问题2——字体图标无法加载

字体和图标不能正常显示

解决方法——修改build文件

打开根目录下build中的utils.js文件,在控制build样式文件代码中添加 publicPath: '../../',

添加publicPath: '../../'

重新npm run build

2. 上传vue 项目并预览

  1. 将项目提交至仓库(包括dist目录),假如仓库名称为test.
  2. $ git subtree push --prefix dist origin gh-pages,将dist目录提交至gh-pages。
  3. 在地址栏输入你的github名称.github.io/test/即可预览。

其他问题

  1. 用mock模拟数据,无法使用。解决方案:创建一个.json文件把数据写死,然后引用这个文件。
  2. 对于使用Vue-cli3.0构建的项目出现的样式失效问题,解决方案:在vue.config.js中设置baseUrl: '/staff/'。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持自由互联。

本文共计568个文字,预计阅读时间需要3分钟。

在Vue项目中,打包并上传到GitHub并实现GitHub Pages预览:

1. 打包Vue项目:在命令行中输入打包命令 `npm run build`,生成dist文件夹。

2.上传到GitHub:将dist文件夹中的内容上传到GitHub仓库的相应分支。

3.配置GitHub Pages:在GitHub仓库的设置中,选择GitHub Pages,并配置分支为存放dist文件夹的分支。

常见问题及解决方法:

1.项目资源无法加载:检查项目中的资源路径是否正确,确保资源文件已包含在dist文件夹中。

vue项目打包后上传至GitHub,并实现github-pages的预览

1. 打包vue 项目

vue项目:

命令行输入打包命令npm run build,生成了dist文件夹:


打包完成。

打包常见问题1——项目资源无法加载

打开刚刚打包好的dist文件夹,浏览器打开index.html


发现该页面是空白的,打开控制台发现

这里看到index.html文件中没有加载任何css、js文件。

解决方法——修改config文件

打开项目根目录config下的index.js文件,进行如下修改:

即将assetsPublicPath: '/'改成assetsPublicPath: './'

重新npm run build

打包常见问题2——字体图标无法加载

字体和图标不能正常显示

解决方法——修改build文件

打开根目录下build中的utils.js文件,在控制build样式文件代码中添加 publicPath: '../../',

添加publicPath: '../../'

重新npm run build

2. 上传vue 项目并预览

  1. 将项目提交至仓库(包括dist目录),假如仓库名称为test.
  2. $ git subtree push --prefix dist origin gh-pages,将dist目录提交至gh-pages。
  3. 在地址栏输入你的github名称.github.io/test/即可预览。

其他问题

  1. 用mock模拟数据,无法使用。解决方案:创建一个.json文件把数据写死,然后引用这个文件。
  2. 对于使用Vue-cli3.0构建的项目出现的样式失效问题,解决方案:在vue.config.js中设置baseUrl: '/staff/'。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持自由互联。