1.Push 提示权限错误（Permission denied）
问题：
| Bash |
原因： 没有配置 SSH key 或使用了 HTTPS 而没有权限。
解决方法：
| Bash |
2.push 报错：rejected non-fast-forward
问题：
| Bash |
原因： 本地代码落后于远程，需要先 pull。
解决方法：
| Bash |
3.忘记添加 .gitignore，上传了无关文件
解决方法：
1.添加或修改 .gitignore 文件
2.移除已跟踪的无用文件：
| Bash |
4. 撤销最近一次 commit
方法 1：只改 commit 信息，不改内容
| Bash |
方法 2：撤回 commit
| Bash |
5.clone 太慢或失败
解决方法：
- 使用国内镜像（如 GitHub 镜像或代理）
- 或使用 SSH 克隆：
| Bash |
6.如何切换/创建分支
| Bash |
7.如何合并分支
| Bash |
有冲突时：
- 手动解决文件冲突
- git add . → git commit
8.如何删除远程分支
| Bash |
9.如何 Fork + PR（Pull Request）参与开源项目？
1.点击项目页面右上角 Fork
2.克隆到本地 → 创建新分支开发
3.提交 → Push 到自己仓库
4.打开自己仓库 → 点 "Compare & pull request"
5.提交 PR 给原项目
10.如何清除 Git 缓存的用户名密码？
| Bash |
11.克隆仓库失败 / 速度慢
常见报错：
- Connection timed out
- fatal: unable to access ...
解决方案：
- 使用 GitClone 镜像
| Bash |
- 或使用 SSH 克隆（加快速度）：
| Bash |
12. GitHub 提示需要访问 Token
报错示例：
| Bash |
原因：
- GitHub 取消了账号密码登录 Git 操作（2021年后）
解决方案：
- 生成 Personal Access Token
- 用 token 代替密码进行 git push、clone
13. 如何修改或重命名仓库
路径：
仓库首页 → Settings → Repository name → 修改 → Save
注意：
- 更改会改变仓库 URL，需要重新 clone 或更新 remote。
14. 如何同步 Fork 仓库
步骤：
| Bash |
或使用 rebase 替代 merge 保持提交整洁。
15. 误删了远程分支怎么办？
如果本地还有该分支：
| Bash |
如果本地也没有：
- 从另一个开发者获取代码
- 或查看 Pull Request 恢复提交内容
16. 如何设置仓库私密 / 公开
路径：仓库首页 → Settings → Danger Zone → Change visibility
17. 如何上传大文件（>100MB）
GitHub 限制单文件大小为 100MB
解决方案：
- 使用 Git Large File Storage（Git LFS）
| Bash |
18. Actions 运行失败
常见原因：
- 缺少权限（例如私有仓库）
- secrets 配置错误
- 网络原因（如下载超时）
排查建议：
- 查看 Actions logs
- 增加超时或使用国内依赖镜像源
- 设置 secrets 时确保 key/value 正确拼写
19. 删除仓库后能恢复吗？
仓库一旦删除，GitHub 不支持恢复。
建议开启删除保护（Settings → Enable delete protection）
20. Pull Request 无法合并
原因可能包括：
- 有冲突（conflict）
- 分支不是目标分支的子分支
- 权限不足（需有 write 权限）
解决方案：
| Bash |
21. 访问 GitHub 卡顿 / 加载慢
使用加速方式：
- https://ghproxy.com/
- https://gitclone.com/
- DNS 优化（如 223.5.5.5）
- 临时 hosts：使用 GitHub520
22. 贡献指南 CONTRIBUTING.md 不生效？
确保文件路径正确为：
| Plain Text |
