答案是：新建GitHub仓库时勾选README会导致本地与远程历史不相关，推送被拒；应先执行git pull origin main --allow-unrelated-histories合并，再删除冗余README并提交，最后推送。
直接推不上去，八成是本地没 commit 过、远程仓库多了一个 README、或者 git remote add origin 用错了地址——先别急着重来，按顺序排查这三处，90% 的同步失败都能当场解决。
本地仓库没 commit 就 push，Git 会静默拒绝
Git 要求本地必须有至少一次提交，才能把内容推到远程。初始化 git init 后如果只执行了 git add . 却漏掉 git commit -m "init"，git push 会报错或无响应（尤其在较新 Git 版本中），但不会明确提示“你还没提交”。
- 检查当前分支是否有提交：
git log --oneline，输出为空说明没 commit 过 - 补提交前确认文件已暂存：
git status看是否显示 “Changes to be committed” - 首次提交建议写清楚项目结构，比如：
git commit -m "feat: init project with src/ and package.json" - 如果项目里已有大量二进制文件（如 PDF、图片），先配好
.gitignore再add，否则后续删起来很麻烦
GitHub 新建仓库时勾选了 README，导致历史不匹配
这是新手最常踩的坑：在 GitHub 页面创建仓库时，误勾了 “Add a README file”，结果远程仓库自带一个初始 commit，而本地是全新仓库，两者没有共同祖先。此时执行 git push 会被拒绝，必须加 --force-with-lease 或先 git pull 合并——但合并后 README 会混进你的源码目录，非常干扰。
- 正确做法：新建仓库时**绝对不要勾选任何初始化选项**（README / .gitignore / License）
- 如果已经勾了，有两个选择：
– 删除远程仓库重来（最快）
– 在本地执行：git pull origin main --allow-unrelated-histories，再手动删掉合并进来的 README 文件，最后git commit -m "chore: remove auto-generated README" - 注意分支名：GitHub 新建空仓库默认分支是
main，不是master；若本地用的是旧版 Git（git branch -M main 切换
remote 地址写错或协议混用，SSH 和 HTTPS 不能交叉验证
git remote add origin 后面跟的 URL 必须和你认证方式严格匹配。用 HTTPS 地址却配置了 SSH 密钥，或反过来，都会卡在权限校验环节，报错类似 Permission denied (publickey) 或 Authentication failed。
- HTTPS 地址长这样：
https://github.com/username/repo.git，推送时会弹窗要你输 GitHub 账号密码（或个人访问令牌 PAT） - SSH 地址长这样：
git@github.com:username/repo.git，依赖本地~/.ssh/id_ed25519.pub已添加到 GitHub Settings → SSH and GPG keys - 检查当前 remote 地址：
git remote get-url origin - 改地址用：
git remote set-url origin git@github.com:username/repo.git（注意不是add，那是新增，不是修改） - Windows 用户特别注意：Git Bash 中复制粘贴 URL 容易带不可见空格，建议手动敲一遍或用鼠标右键粘贴后检查首尾
同步前必须确认的三个全局配置
这些配置不直接影响 push 成败，但一旦出问题（比如换行符混乱、提交者信息缺失），会导致协作时被队友吐槽，甚至 CI 失败。
- 用户名和邮箱必须和 GitHub 账号一致：
git config --global user.name "YourName"、git config --global user.email "yourname@github.com" - 换行符策略按系统设：
git config --global core.autocrlf true（Windows）、git config --global core.autocrlf input（macOS/Linux） - 启用颜色输出，减少误判：
git config --global color.ui auto - 验证是否生效：
git config --list | grep -E "(user|autocrlf|color)"
真正卡住的地方，往往不在 push 命令本身，而在它之前的那几步——尤其是 commit 是否真实发生、远程仓库是否真的“空”、以及你用的地址到底走的是哪条认证通道。多看一眼 git status 和 git remote get-url origin，比反复试 push 有用得多。
