执行npm run deploy部署Vue项目到gh-pages时出现src refspec main不匹配错误

错误原因 #

你遇到的error: src refspec main does not match any，核心问题出在deploy.sh的推送命令上：

• 在dist目录下新初始化的Git仓库，若使用的是旧版本Git，默认分支名可能是master而非main，此时你指定推送main分支，本地找不到对应分支就会报错。
• 另外你的vue.config.js存在两次module.exports，第二个配置会完全覆盖第一个，虽然暂时不影响部署，但属于不规范写法，可能引发潜在问题。

具体修复步骤 #

1. 修正deploy.sh的推送命令 #

将推送命令改为自动适配当前本地分支，避免分支名不匹配的问题：

git push -f git@github.com:myname/todo-list.git HEAD:gh-pages

HEAD会自动指向当前本地分支，无论分支是main还是master，都能正确推送到远程的gh-pages分支（远程分支不存在时会自动创建）。

2. 合并vue.config.js的配置 #

把两个独立的module.exports合并为一个，确保所有配置生效：

const { defineConfig } = require('@vue/cli-service')
module.exports = defineConfig({
  transpileDependencies: true,
  publicPath: process.env.NODE_ENV === 'production'
    ? '/todo-list/'
    : '/'
})

3. 验证build结果 #

运行npm run build后，检查dist目录是否生成了完整的静态文件（如index.html、css、js文件夹）。如果dist为空，说明构建过程存在错误，需先排查构建日志解决问题。

可选：简化部署流程 #

如果不想维护自定义脚本，可以使用Vue CLI官方的部署插件：

• 安装插件：npm install vue-cli-plugin-gh-pages --save-dev
• 执行部署：vue-cli-service gh-pages:deploy

关于gh-pages分支的说明 #

你的理解完全正确：gh-pages分支只需要包含构建后的静态文件，无需手动从main分支创建。只要推送命令正确，脚本会自动在远程仓库创建该分支并推送dist目录的内容。

内容的提问来源于stack exchange，提问作者happy_story