GitHub | 在 GitHub 上在线展示 Vue 项目

Step1:在 GitHub 上新建仓库,并将 Vue 项目的代码 push 到该仓库中。坑点在于,如果你是从 GitHub 上 clone 的别人的项目,那么在使用 git 时,需要修改 origin 的 URL 地址为你自己仓库的地址,代码如下。

git remote set-url origin git@github.com:<你自己仓库的SSH地址>

我就差点提交到别人的仓库去了 TT

Step2:如果此前你从来没有对项目进行 build(构建)的话,那么是不会有这个 dist 目录的(如下)而要想使用 GitHub Pages 功能在线展示项目网页,这个 dist 目录又是必不可少的。

因此,我们需要 build 项目,并将生成的 dist 目录上传到 GitHub 仓库中。

Step3:在使用 npm run build 时可能报错 "npm ERR! missing script: build",这是因为你的项目没有定义名为 "build" 的脚本。因此,到项目中的 package.json 文件中查看现有的脚本:

比如,我的项目中定义的 build 脚本如上,那么我应该输入命令:

npm run build:prod

我随便选的,因为第一个看起来更正常。

Step4:build 完毕后,我们将得到 Step2 中展示的 dist 目录,里面装有一个 HTML 页面和一些静态资源。

如果你点开 index.html,发现是一片空白,那么可能需要修改项目中的 vue.config.js 文件,如下图所示。

我这里原本是 publicPath: "/",少了一个点,修改后再打包,最终 HTML 显示成功。如果你没有这一行,那么可能需要添加上去(我刷到过其他博客是这样解决的)

Step5:如果 index.html 显示成功了,那么我们就可以把 dist 目录上传到仓库中了(实测手动上传的方法治标不治本,建议采取后面一种方法)。

在跳转后的页面,把 dist 目录拖拽进去,最后 commit 即可。

相关推荐
wflynn20 分钟前
GitHub 日榜趋势速报 | 2026-11-17
开源·github
Mh9 小时前
我是如何设计品牌站组件库的?
前端·css·设计模式
程序员大阳10 小时前
副队长Vue3教程(2)--Vite 搭建 Vue 项目,认识目录结构
前端·javascript·vue.js·vite·创建项目·目录结构·项目结构
濮水大叔10 小时前
Cabloy/Zova 与 Next.js 的 SSR 水合差异
前端·typescript·next.js
SoaringHeart10 小时前
Flutter最佳实践:用 flutter_html 渲染富文本
前端·flutter
Flynt12 小时前
Chrome给AI编程助手塞了203篇前端规范,我拆包实测:检索0.77秒是真快,扫描器有点挑食
前端·chrome·ai编程
北城笑笑12 小时前
Vue 110 ,若依SSE流式接口限次空500排查与解决
前端·javascript·vue.js·后端·vue
程序员韩星12 小时前
OpenAI 兼容接口返回 404,先查请求地址,再查模型名
前端·人工智能·http
Patrick_Wilson12 小时前
构建通过了,为什么有些浏览器还会白屏?
前端·javascript·浏览器
其实防守也摸鱼13 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构