技术 · 实用指南
Git 报“src refspec main does not match any”？推送前先证明本地源
这个错误指向 refspec 的本地源，并不证明 GitHub 拒绝了已有分支。先验证 HEAD 是提交、refs/heads/main 确实存在，再选择首次提交、正确分支或显式 HEAD 映射。
“src refspec main does not match any”表示 Git 无法解析推送命令左侧的本地源。它不等于远端已有冲突的 main，也不等于认证失败，更不是必须强推。
冻结原命令，然后在本地证明两件事：HEAD 能解析为提交，且命令指定的源引用确实存在。之后才决定首次提交、推送实际分支、谨慎改名或把 HEAD 显式映射到远端目标。
保留命令并证明 HEAD
保存完整 push 命令、仓库路径、git status --short --branch、git branch --show-current 与 git remote -v。脚本可能写死 main，而本地实际是 master、其他名称或 detached HEAD。
执行 git rev-parse --verify HEAD^{commit}。若新仓库失败，先审查文件，只暂存应进入历史的内容并创建真实首次提交；不要为消除报错盲造空提交。
核对精确的本地源引用
命令指定 main 时，执行 git show-ref --verify refs/heads/main。非零结果表示这个本地分支确实不存在，即使远端跟踪引用或标签里出现 main。
比较 git symbolic-ref --short -q HEAD 与 git branch --show-current。若目标提交位于其他本地分支，就推送该分支或有意识地改名，不要假设托管平台默认分支会自动改写本地引用。
需要时使用显式映射
若 HEAD 已解析为正确提交但不应创建本地 main，可使用 git push -u origin HEAD:refs/heads/main。左侧是已证明的源对象，右侧是要更新的远端分支。
若确实要有本地 main，先确认它应指向哪个提交再创建或改名，并重新运行 show-ref 与 git log -1 --decorate。
把远端拒绝分到另一条路径
若 Git 已联系远端并报告 non-fast-forward，说明本地源解析成功。先 fetch，检查分叉，再按仓库政策整合远端工作。
不要用 --force 修复“does not match any”。force 只改变源已解析后的更新规则，不能凭空创建缺失的本地源，还可能覆盖错误分支的远端历史。
验证结果并收尾
只做一处窄修正后再推送一次，完整阅读输出。确认显示的源与目标、-u 设置的上游以及 git rev-parse HEAD 的提交 ID。
检查 git status --short --branch 与 git ls-remote --heads origin main，并记录根因是未出生历史、分支名错误、detached HEAD、封装器配置还是独立的远端分叉。
