简单实现vue github
实现 Vue 项目并托管到 GitHub 的步骤
创建 Vue 项目
使用 Vue CLI 快速初始化项目,确保已安装 Node.js 和 npm/yarn。
运行命令:
npm init vue@latest my-vue-project
进入项目目录后安装依赖:
cd my-vue-project && npm install
本地开发与测试
启动开发服务器:
npm run dev
项目默认运行在 http://localhost:5173,修改代码后会自动热更新。
配置 GitHub 仓库
在 GitHub 上创建新仓库(如 my-vue-project),不要勾选 README 或 LICENSE 初始化选项。
本地项目关联远程仓库:
git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/your-username/my-vue-project.git
git push -u origin main
部署到 GitHub Pages
安装 gh-pages 依赖:
npm install gh-pages --save-dev
在 package.json 中添加部署脚本:
"scripts": {
"predeploy": "npm run build",
"deploy": "gh-pages -d dist"
}
运行部署命令:
npm run deploy
完成后通过 https://your-username.github.io/my-vue-project 访问项目。
关键注意事项
- 确保
vite.config.js中设置正确的base路径(如/my-vue-project/)。 - GitHub Pages 默认从
gh-pages分支的dist目录部署,无需手动创建该分支。 - 若使用自定义域名,需在仓库设置中配置并在项目根目录添加
CNAME文件。







