开发者必备的 Git 命令速查宝典

来自 clawdbot 官方技能集的 Git 命令速查手册，覆盖版本控制全流程，帮助开发者高效管理代码协作与分支。

基本信息

• 技能名称?git-essentials
• 中文名称?开发者必备的 Git 命令速查宝典
• 作者?Arnarsson
• 分类?开发
• 版本?1.0.0
• 标签?git, development-engineering, docs, productivity, automation

使用方法

使用说明
核心用法
Git Essentials 是一个纯文档型的 Git 命令参考技能，系统梳理了从初始化配置到高级操作的全套 Git 工作流。内容涵盖：用户配置与仓库初始化、日常暂存提交循环、分支创建与合并策略、远程仓库同步、历史日志查询、变更撤销与恢复、储藏（stash）管理、交互式变基（rebase）、标签发布，以及 cherry-pick、子模块等进阶操作。每个命令均配有实际可执行的 Bash 示例，并标注了现代替代语法（如 git switch 取代 git checkout ）。
显著优点

1. 结构清晰，速查友好 ：按工作场景模块化组织，开发者可快速定位所需命令，无需翻阅冗长文档。
2. 实战导向 ：不仅罗列命令，更提供 Feature Branch、Hotfix、Fork 同步等完整工作流模板，直接可用于团队协作。
3. 安全提示到位 ：对 git reset --hard 、 、 git push --force 等高危操作明确标注风险，并推荐使用 --force-with-lease` 等更安全的替代方案。
4. 零依赖零配置 ：纯 Markdown 文档，无需安装额外依赖，仅需系统预装 Git 即可配合查阅使用。
   潜在缺点与局限性
5. 无交互式引导 ：作为静态文档，无法根据用户当前 Git 状态智能推荐下一步操作，新手可能仍需结合 git status 等命令自行判断。
6. 缺乏可视化辅助 ：分支合并、变基等复杂操作仅靠文字描述，对图形化学习偏好者不够直观（虽提供了外部可视化指南链接）。
7. 命令版本差异 ：部分现代语法（如 git switch 、 、 git restore`）需要 Git 2.23+，旧版本用户需注意兼容性。
8. 不覆盖 CI/CD 集成 ：专注于本地操作，未涉及 GitHub Actions、GitLab CI 等自动化场景。
   适合的目标群体
   Git 初学者 ：需要系统学习标准命令与协作规范的入门开发者
   全栈工程师 ：日常频繁切换分支、处理合并冲突，需要快速查阅准确语法
   技术团队 Lead ：制定团队 Git 工作流规范时作为参考基准
   开源贡献者 ：需要掌握 Fork 同步、Rebase 清理提交历史等进阶技巧
   使用风险
9. 误操作风险 ：文档中包含 reset --hard 、 、 push --force` 等破坏性命令，用户直接复制执行可能导致代码丢失，务必理解后再操作。
10. 环境差异 ：部分别名配置（ ~/.gitconfig 示例）可能覆盖用户现有设置，建议先备份。
11. 子模块复杂性 ：子模块操作涉及多仓库状态同步，新手易陷入"子模块未初始化"等常见陷阱。
12. 性能考量 ：大型仓库中 git log --graph --all 等命令可能响应缓慢，文档未提及性能优化建议。