结论：远程分支创建失败主因是本地分支不存在、命名错误或未设上游，而非网络/认证问题；“src refspec does not match any”表明Git未发起网络请求，仅本地查找失败。
直接说结论：远程分支创建失败，90% 以上不是网络或认证问题，而是本地分支根本不存在、名字拼错、或者没设置上游追踪。
git push origin feature/x 报 “src refspec does not match any”
这是最典型的假性“网络失败”——Git 根本没发请求，它连远程都没碰，只是在本地找 feature/x 分支失败了。
- 运行
git branch，确认输出里真有feature/x（带星号表示当前分支） - 如果没看到，说明分支压根没创建：
git checkout -b feature/x或git switch -c feature/x - 如果看到了但没星号，说明你不在该分支上，先
git switch feature/x - 注意大小写和斜杠：GitHub 不区分大小写但 Git 区分，
Feature/x≠feature/x；Windows 路径习惯用反斜杠，但分支名必须用正斜杠
git push -u origin feature/x 没反应或卡住
这时才真正进入网络/认证环节。但“没反应”不等于“连不上”，更可能是凭据卡在后台等待输入。
- 先试
git ls-remote origin：能列出 refs 就说明连接和认证都通；报authentication failed或repository not found才是权限问题 - HTTPS 方式下，若系统弹窗没出现或凭据管理器存了过期 PAT，Git 会静默卡住。改用
git config --global credential.helper store临时启用明文凭据缓存，再推一次看是否弹登录框 - SSH 方式下，检查
ssh -T git@github.com（或对应平台域名）是否返回 “Hi xxx! You've successfully authenticated.” - 别信“网络不稳定”——Git 的 HTTP 请求要么秒回错误，要么明确超时（如
Failed to connect to github.com port 443），不会“无响应”
远程仓库拒绝创建分支：permission denied 或 forbidden
这确实是权限问题，但错误信息往往很直接，不会伪装成网络失败。
- 常见错误文本：
remote: Permission to owner/repo.git denied to user、remote: You are not allowed to push code to this project - 不是所有远程平台都允许用户随意建分支：GitHub 默认允许，但 GitLab / 自建 Gitea 可能限制为 protected branches + 管理员白名单
- 检查仓库 Settings → Branches → Branch protection rules，看是否有规则禁止推送新分支（比如只允许从
main创建） - 如果用的是组织级仓库，确认你的账号在该组织中拥有
write权限（不是read或maintain以下）
最容易被忽略的点：Git 从不“创建远程分支”，它只推送一个本地分支到远程——所谓“新建远程分支”，本质是把本地一个已有提交（哪怕只有 1 个空提交）推送到远程一个尚不存在的分支名。所以一切的前提，是本地分支存在、有至少一个 commit、且命名准确。认证和权限只是最后一道门禁，别在门口反复敲门，先确认自己手里真有钥匙。
