作为全球最大的代码托管平台，GitHub日常使用中难免遇到各种"坑"。本文汇总开发者最常遇到的八大问题及其解决方案，助你高效避坑。
一、仓库克隆失败（错误提示：Permission denied）
典型场景：
git clone git@github.com:user/repo.git
Permission denied (publickey). fatal: Could not read from remote repository.解决方案：
检查SSH密钥配置
# 生成新密钥（已有密钥跳过）
ssh-keygen -t ed25519 -C "your_email@example.com"
# 将公钥添加到GitHub
cat ~/.ssh/id_ed25519.pub测试连接：
ssh -T git@github.com
# 成功显示：Hi username! You've successfully authenticated...若使用HTTPS克隆，更新凭证存储：
git config --global credential.helper store二、推送时认证失败（HTTP 403错误）
问题根源：2021年8月起GitHub停止支持密码验证
正确操作：
生成个人访问令牌(PAT)：
Settings → Developer settings → Personal access tokens
勾选repo和workflow权限
用令牌替代密码：
git remote set-url origin https://<TOKEN>@github.com/USER/REPO.git三、合并冲突处理指南
冲突发生场景：
CONFLICT (content): Merge conflict in file.txt
Automatic merge failed; fix conflicts and then commit the result.解决步骤：
打开冲突文件，定位<<<<<<< HEAD到>>>>>>> branch-name标记区域
手动选择保留的代码段，删除冲突标记
标记为已解决：
git add file.txt
git commit -m "Resolve merge conflict"预防建议：
# 合并前先拉取最新代码
git pull --rebase origin main四、误删分支的恢复技巧
恢复被删分支：
# 查找被删分支的最后提交哈希
git reflog
# 基于哈希重建分支
git checkout -b recovered-branch <commit-hash>永久防护设置：
进入仓库Settings → Branches
添加分支保护规则：启用Require pull request reviews和Include administrators
五、大文件提交错误（超过100MB）
错误提示：
remote: error: File large_file.zip is 1024.00 MB; this exceeds GitHub's file size limit of 100.00 MB
解决方案：
撤销最近提交：
git reset HEAD~1使用Git LFS管理大文件：
# 安装Git LFS
git lfs install
# 追踪大文件类型
git lfs track "*.zip"
# 重新提交
git add .gitattributes
git add large_file.zip
git commit -m "Add large file via LFS"六、GitHub Actions执行失败排查
常见故障点：
权限不足：在workflow中启用permissions
permissions:
contents: write
pull-requests: write环境变量缺失：在仓库Settings → Secrets中添加变量
路径错误：使用$GITHUB_WORKSPACE替代硬编码路径
超时问题：设置timeout-minutes参数
jobs:
build:
timeout-minutes: 30七、仓库无法访问（DNS污染应对）
症状：github.com域名解析失败
解决方案：
修改hosts文件（管理员权限）：
# Windows: C:\Windows\System32\drivers\etc\hosts
# Linux/Mac: /etc/hosts
20.205.243.166 github.com
20.205.243.166 www.github.com刷新DNS缓存：
# Windows
ipconfig /flushdns
# Mac/Linux
sudo killall -HUP mDNSResponder八、敏感信息泄露急救
误提交密码/密钥后：
立即撤销提交：
git reset --soft HEAD~1若已推送到远程：
# 从历史记录中彻底删除文件
git filter-branch --force --index-filter \
"git rm --cached --ignore-unmatch config/secret.conf" \
--prune-empty --tag-name-filter cat -- --all强制推送：
git push origin --force --all在GitHub后台重置所有密钥
重要提示：操作前务必备份仓库！
九、子模块更新问题
子模块无法同步：
git submodule update --init --recursive更新所有子模块：
git submodule foreach git pull origin main十、最佳实践建议
分支管理：采用Git Flow模型，区分main、develop、feature分支
提交规范：使用Conventional Commits格式
安全防护：开启双因素认证（2FA）
代码检查：配置pre-commit钩子自动检测
# .pre-commit-config.yaml
repos:
- repo: https://github.com/pre-commit/pre-commit-hooks
rev: v4.4.0
hooks:
- id: trailing-whitespace
- id: end-of-file-fixer结语
掌握这些GitHub高频问题的解决方案，能显著提升开发效率。建议收藏本文链接，下次遇到问题时快速定位解决方案。GitHub官方文档也是极佳的资源库，遇到复杂问题时不妨查阅GitHub Docs。记住：每次解决新问题都是技术成长的契机！
本文内容仅供个人学习、研究或参考使用，不构成任何形式的决策建议、专业指导或法律依据。未经授权，禁止任何单位或个人以商业售卖、虚假宣传、侵权传播等非学习研究目的使用本文内容。如需分享或转载，请保留原文来源信息，不得篡改、删减内容或侵犯相关权益。感谢您的理解与支持！