在协同开发的数字世界里，Git已成为代码版本控制的事实标准。然而，对新手而言，其纷繁的命令和概念常常令人望而生畏。一份精心整理的Git版本控制工具常用命令新手速查表，其核心价值在于提供一个清晰、按场景分类的行动指南，帮助开发者在关键时刻（如代码提交出错、分支合并冲突时）快速找到正确命令，从而建立信心、提升效率，并安全地迈出从个人修改到团队协作的第一步。本文不仅是一张命令列表，更是一套融入最佳实践的工作流解读。
一、 奠基：仓库初始化与基础配置
在开始任何操作前，正确的初始化和身份配置是基石。这部分命令通常只需要执行一次。
| 命令 | 作用与示例 | 关键说明 |
|---|---|---|
git init | 在当前目录创建全新的Git仓库。git init my-project | 生成隐藏的 .git 目录，这是Git的“数据库”。 |
git clone [url] | 克隆（下载）远程仓库到本地。git clone https://github.com/user/repo.git | 最常用的开局命令，自动建立远程跟踪。 |
git config --global user.name “[name]” | 配置全局用户名。 | 提交代码的“作者签名”，必须正确设置。 |
git config --global user.email “[email]” | 配置全局邮箱。 | 应与GitHub/GitLab等账号邮箱一致。 |
git config --list | 查看所有当前配置。 | 用于验证配置是否正确。 |
在鳄鱼java的新人入职手册中，正确配置Git身份是提交代码前的强制检查项，这保证了项目历史清晰可追溯。
二、 日常单兵作战：本地修改与提交
这是开发者最常接触的工作流，理解工作区、暂存区、仓库的三段式提交是关键。
| 命令 | 作用与示例 | 关键说明 |
|---|---|---|
git status | 查看工作区和暂存区的状态。当你不知道下一步该干嘛时，首先运行它。 | 显示哪些文件被修改、哪些已暂存。 |
git add [file] | 将文件修改添加到暂存区。git add .（添加所有变更）git add src/（添加目录） | . 是通配符，代表当前目录所有变更。 |
git commit -m “[message]” | 将暂存区的内容提交到本地仓库，并附上提交信息。git commit -m “修复用户登录空指针异常” | 提交信息应简明扼要，说明“为什么”修改。 |
git diff | 查看工作区与暂存区的差异。 | 在git add前，确认修改内容。 |
git diff --staged | 查看暂存区与上次提交的差异。 | 在git commit前，确认将要提交的内容。 |
git restore [file] | （Git 2.23+） 丢弃工作区对某个文件的修改，恢复到最后一次提交或暂存的状态。git restore broken.txt | 危险操作！未提交的修改将永久丢失。替代了旧的 git checkout -- [file]。 |
git restore --staged [file] | 将文件从暂存区移回工作区，但保留修改内容。git restore --staged mistakenly-added.txt | 当你误将不需要提交的文件add了，可以用此命令取消暂存。 |
一个标准的提交周期是：编码 -> `git status` -> `git add` -> `git diff --staged` -> `git commit`。这份Git版本控制工具常用命令新手速查表的核心就是固化这个肌肉记忆。
三、 时空穿越与并行宇宙：分支操作
分支是Git的杀手锏，让你能安全地隔离开发功能或修复Bug。
| 命令 | 作用与示例 | 关键说明 |
|---|---|---|
git branch | 列出所有本地分支，当前分支前有 * 号。 | 常用 -a 选项查看所有（本地+远程）分支。 |
git branch [branch-name] | 基于当前分支创建新分支。git branch feature-auth | 只创建，不切换。 |
git checkout [branch-name]或 git switch [branch-name] | 切换到指定分支。git switch feature-auth | git switch 是更语义化的新命令（Git 2.23+），专用于切换分支。 |
git checkout -b [branch-name]或 git switch -c [branch-name] | 创建并立即切换到新分支。git switch -c hotfix-urgent | 最常用的组合命令，用于开始新功能开发。 |
git merge [branch-name] | 将指定分支的修改合并到当前分支。git switch maingit merge feature-auth | 产生一个额外的合并提交，保留完整分支历史。 |
git rebase [base-branch] | 将当前分支的修改“重新播放”到目标分支的最新提交之后。git switch featuregit rebase main | 得到更线性的历史，但不要对已推送的提交执行rebase。 |
git branch -d [branch-name] | 删除已合并的本地分支。 | 清理已完成工作的分支，保持简洁。 |
git branch -D [branch-name] | 强制删除未合并的本地分支。 | 危险操作，会丢失该分支上的工作。 |
在鳄鱼java的项目中，我们遵循“主分支（main/master）保护，功能开新分支”的原则，这是现代协作开发的基础。
四、 团队协作战役：远程仓库同步
与团队共享代码和获取更新，是Git协作的核心。
| 命令 | 作用与示例 | 关键说明 |
|---|---|---|
git remote -v | 查看已配置的远程仓库地址。 | 通常名为 origin。 |
git fetch [remote] | 从远程仓库下载所有分支的更新到本地，但不合并。git fetch origin | 安全的“看看别人做了什么”，不会影响你的工作。 |
git pull [remote] [branch] | 拉取远程分支并立即合并到当前分支。git pull origin main | 相当于 git fetch + git merge。可能导致合并冲突。 |
git push [remote] [branch] | 将本地分支推送到远程仓库。git push origin feature-auth | 首次推送可使用 -u 选项建立跟踪：git push -u origin feature-auth。 |
git push --force-with-lease | 相对安全的强制推送。仅在远程分支没有你未拥有的新提交时才强制覆盖。 | 比 git push --force 安全得多，是回退已推送提交的首选。 |
五、 侦探与时光机：查看历史与撤销
当需要排查问题或纠正错误时，这些命令是你的救命稻草。
| 命令 | 作用与示例 | 关键说明 |
|---|---|---|
git log --oneline --graph | 以简洁的单行和图形化方式查看提交历史。 | 添加 --all 查看所有分支历史。 |
git log -p [file] | 查看指定文件的详细修改历史。 | 定位Bug引入点的利器。 |
git show [commit-id] | 查看某次提交的详细内容和元数据。 | commit-id 取前7位即可。 |
git reset --soft [commit] | 将当前分支的HEAD指针回退到指定提交，但保留工作区和暂存区的修改。 | 用于重新组织提交（撤销commit但保留代码）。 |
git reset --mixed [commit] | （默认）回退HEAD指针和暂存区，但保留工作区修改。 | 用于撤销add和commit。 |
git reset --hard [commit] | 危险！ 彻底回退到指定提交，丢弃所有工作区和暂存区的修改。 | 仅用于丢弃所有未提交的修改，或放弃本地实验。 |
六、 总结：从命令记忆到工作流内化
这份Git版本控制工具常用命令新手速查表的价值，不在于你背诵了每一个参数，而在于它为你勾勒出了一幅清晰的Git作战地图。它将看似零散的指令，整合到了“初始化-日常修改-分支开发-团队同步-查看回溯”这个连贯的工作流中。
在鳄鱼java的团队实践中，我们强调将这份速查表作为起点，更重要的是理解每个操作背后的意图（例如，`add`是准备，`commit`是存档，`push`是发布）。当遇到合并冲突时，你不再恐慌，因为你知道这是团队协作的正常部分，可以通过`git status`查看冲突文件，手动解决后重新`add`和`commit`。
现在，请将这份指南放在手边，并在下一个个人项目或练习仓库中刻意使用。当你不再需要频繁查看本表，而是能流畅地运用分支策略、清晰地书写提交信息、自信地处理同步冲突时，你就已经完成了从Git新手到有效协作者的华丽转身。记住，精通Git不是记住所有命令，而是建立正确的版本控制思维模型。
