# Git 最佳实践与常见问题 > 📚 Git 教程系列 - 第 8 篇 > 📅 最后更新：2026-03-15 > 💡 适合人群：所有 Git 用户 --- ## 📋 提交信息规范 ### 基本格式 ``` ():

``` ### 类型说明 | 类型 | 说明 | 示例 | |------|------|------| | `feat` | 新功能 | `feat(auth): 添加用户登录` | | `fix` | 修复 bug | `fix(api): 修复 500 错误` | | `docs` | 文档更新 | `docs(readme): 更新安装说明` | | `style` | 格式调整 | `style(code): 格式化代码` | | `refactor` | 重构 | `refactor(core): 重构核心模块` | | `test` | 测试 | `test(auth): 添加登录测试` | | `chore` | 构建/工具 | `chore(deps): 更新依赖` | ### 完整示例 ``` feat(auth): 添加用户登录功能 - 实现 JWT 认证 - 添加登录/注册接口 - 添加密码加密 Closes #123 ``` --- ## 🌿 分支管理最佳实践 ### 分支命名 ```bash # ✅ 推荐 feature/user-authentication fix/login-bug-500 hotfix/security-patch release/v1.0.0 experiment/new-ui # ❌ 不推荐 test new fix 123 ``` ### 分支生命周期 ```bash # 1. 从最新 develop 创建 git checkout develop git pull git checkout -b feature/new-feature # 2. 定期同步 develop git fetch origin git rebase origin/develop # 3. 完成后合并 git checkout develop git merge --no-ff feature/new-feature # 4. 删除分支 git branch -d feature/new-feature git push origin --delete feature/new-feature ``` ### 分支保护 **GitHub 设置：** 1. Settings → Branches 2. Add branch protection rule 3. 分支模式：`main` 4. 启用选项： - ✅ Require pull request reviews - ✅ Require status checks to pass - ✅ Require branches to be up to date - ✅ Include administrators --- ## 📦 提交频率 ### 推荐做法 ```bash # ✅ 小步提交 git add src/auth/login.py git commit -m "feat(auth): 添加登录接口" git add src/auth/register.py git commit -m "feat(auth): 添加注册接口" git add tests/test_auth.py git commit -m "test(auth): 添加认证测试" # ❌ 一次性提交所有 git add . git commit -m "更新代码" ``` ### 提交检查清单 - [ ] 代码已测试 - [ ] 提交信息清晰 - [ ] 没有敏感信息 - [ ] 没有调试代码 - [ ] 没有大文件 --- ## 🔐 安全实践 ### 不要提交的内容 ```bash # .gitignore 示例 # 密码和密钥 *.pem *.key .env config/secrets.yml # IDE 配置 .vscode/ .idea/ *.swp # 依赖 node_modules/ venv/ __pycache__/ # 构建产物 dist/ build/ *.pyc # 系统文件 .DS_Store Thumbs.db ``` ### 检查敏感信息 ```bash # 检查是否提交了密码 git log -p | grep -i "password" git log -p | grep -i "secret" git log -p | grep -i "api_key" # 使用工具检查 git-secrets --scan trufflehog git file://. ``` ### 如果已提交敏感信息 ```bash # 1. 立即撤销提交 git reset --hard HEAD~1 # 2. 或从历史中删除 git filter-branch --force --index-filter \ "git rm --cached --ignore-unmatch path/to/secret" \ --prune-empty --tag-name-filter cat -- --all # 3. 强制推送 git push -f origin main # 4. 更改所有相关密码 ``` --- ## 🛠️ 常见问题解决 ### 问题 1：提交错了文件 ```bash # 如果刚提交，还没推送 git reset --soft HEAD~1 git reset HEAD wrong-file.txt git commit -m "正确的提交信息" # 如果已推送 git revert HEAD ``` ### 问题 2：合并冲突 ```bash # 1. 查看冲突文件 git status # 2. 编辑冲突文件 # 找到冲突标记： # <<<<<<< HEAD # 你的修改 # ======= # 对方的修改 # >>>>>>> feature # 3. 解决冲突，保留需要的代码 # 4. 标记解决 git add conflicted-file.txt # 5. 完成合并 git commit -m "解决合并冲突" # 或取消合并 git merge --abort ``` ### 问题 3：忘记创建分支 ```bash # 在 main 上开发了几次提交后才发现 # 1. 创建新分支 git branch feature/new-feature # 2. 回退 main git reset --hard HEAD~3 # 3. 切换到新分支 git checkout feature/new-feature # 4. 推送 git push -u origin feature/new-feature ``` ### 问题 4：想修改历史提交 ```bash # 使用交互式 rebase git rebase -i HEAD~3 # 编辑器会显示： # pick a1b2c3d 提交 1 # pick e5f6g7h 提交 2 # pick i9j0k1l 提交 3 # 修改为： # pick a1b2c3d 提交 1 # squash e5f6g7h 提交 2 # 合并到上一个 # reword i9j0k1l 提交 3 # 修改提交信息 # 保存并退出 ``` ### 问题 5：大文件处理 ```bash # 安装 Git LFS git lfs install # 跟踪大文件类型 git lfs track "*.psd" git lfs track "*.zip" git lfs track "*.mp4" # 提交 .gitattributes git add .gitattributes git commit -m "Configure Git LFS" # 正常提交大文件 git add large-file.psd git commit -m "Add design file" git push origin main ``` --- ## 📊 性能优化 ### 清理仓库 ```bash # 清理不必要的文件 git gc # 更激进的清理 git gc --aggressive # 检查仓库大小 git count-objects -vH ``` ### 浅克隆 ```bash # 只克隆最近 N 次提交 git clone --depth 1 git@github.com:user/repo.git # 克隆特定分支 git clone --depth 1 --branch main git@github.com:user/repo.git # 后续获取完整历史 git fetch --unshallow ``` ### 稀疏检出 ```bash # 只检出特定目录 git clone --filter=blob:none --sparse git@github.com:user/repo.git cd repo git sparse-checkout set folder1 folder2 ``` --- ## 🎯 团队协作规范 ### Code Review 流程 ```bash # 1. 创建 PR/MR # 标题清晰，描述完整 # 2. 等待 Review # - 至少 1 人批准 # - 解决所有评论 # 3. 合并 # - Squash and merge（推荐） # - Create a merge commit # - Rebase and merge ``` ### PR 描述模板 ```markdown ## 变更说明 - 功能 1 - 功能 2 ## 相关 Issue Closes #123 ## 测试 - [ ] 单元测试通过 - [ ] 集成测试通过 - [ ] 手动测试通过 ## 截图（如果有 UI 变更） ## 检查清单 - [ ] 代码符合规范 - [ ] 已更新文档 - [ ] 无敏感信息 ``` --- ## 📚 推荐工具 ### GUI 客户端 | 工具 | 平台 | 价格 | |------|------|------| | GitHub Desktop | Win/Mac | 免费 | | GitKraken | Win/Mac/Linux | 付费 | | SourceTree | Win/Mac | 免费 | | Fork | Win/Mac | 付费 | | VS Code Git | 全平台 | 免费 | ### 命令行增强 ```bash # 安装 git-delta（更好的 diff） brew install git-delta git config --global core.pager delta git config --global interactive.diffFilter "delta --color-only" # 安装 git-fuzzy（模糊搜索） git config --global alias.st "fuzzy-status" ``` ### 在线工具 - [GitHut](https://git.hut/) - GitHub 统计 - [GitHistory](https://githistory.xyz/) - 历史可视化 - [GitGraph](https://gitgraphjs.com/) - 分支图生成 --- ## 🎓 学习资源 ### 官方文档 - [Git 官方文档](https://git-scm.com/doc) - [GitHub 文档](https://docs.github.com/zh) - [Gitee 文档](https://gitee.com/help) ### 互动教程 - [Learn Git Branching](https://learngitbranching.js.org/) - [Git 教程 - 菜鸟教程](https://www.runoob.com/git/git-tutorial.html) ### 书籍 - 《Pro Git》（免费电子书） - 《Git 权威指南》 - 《Git 入门指南》 --- ## 🎯 小结 ### 每日检查 - [ ] 提交信息清晰 - [ ] 分支命名规范 - [ ] 没有敏感信息 - [ ] 及时同步远程 - [ ] 定期清理分支 ### 命令速查 | 场景 | 命令 | |------|------| | 查看状态 | `git status` | | 查看日志 | `git log --oneline --graph` | | 撤销修改 | `git checkout -- file` | | 回退版本 | `git reset --hard commit` | | 安全回退 | `git revert commit` | | 找回数据 | `git reflog` | | 清理仓库 | `git gc` | | 浅克隆 | `git clone --depth 1` | --- ## 🎉 恭喜完成 Git 教程！你已经学完了所有 Git 基础知识和高级技巧。接下来： 1. **多练习** - 在实际项目中使用 Git 2. **养成好习惯** - 规范提交、合理分支 3. **持续学习** - Git 功能丰富，不断探索 4. **分享知识** - 帮助他人理解 Git --- > 📖 **教程系列完成！** > 有问题随时回来查阅，祝 coding 愉快！🚀