没有人记得每个 Git 命令，你也不需要记住。此 Git 命令备忘单 重点关注涵盖几乎所有日常工作的小集合，并按您想要执行的工作进行分组。

我们使用 Windows 版 Git 在一次性演示存储库中测试了本地命令，显示的输出来自该运行，并删除了行结束警告。您的提交哈希值会有所不同。远程命令需要服务器，因此我们没有运行它们。版本控制新手？从我们的 Git 初学者教程开始。

Git 如何思考：三个领域

一旦你知道变更发生在哪里，大多数困惑就会消失：

设置并启动项目

保存您的工作

以下是随着新文件的移动，简短状态视图如何变化：

$ echo "hello" > app.txt
$ git status --short
?? app.txt

$ git add app.txt
$ git status --short
A  app.txt

$ git commit -m "Add app file"

?? 表示未跟踪，A 表示添加到暂存中。在两列格式中，左列是暂存区域，右列是工作目录。请注意，git commit -am 会跳过全新文件，因此您必须首先明确添加这些文件。

分支机构

这是从开始到结束的一个小功能分支：

$ git switch -c feature/login
$ echo "login" >> app.txt
$ git commit -am "Add login"
$ git switch main
$ git merge --no-edit feature/login
$ git log --oneline --graph
* d0450b6 Add login
* 676b684 Add app file

$ git branch -d feature/login
Deleted branch feature/login (was d0450b6).

历史是一条直线，因为 main 没有移动，所以 Git 进行了快进合并。您仍然会在旧指南中看到 git checkout。它有效，但较新的 switch 和 restore 命令将其许多工作分解为更清晰的工作。要在合并和变基之间进行选择，请阅读 Git merge 与 rebase。

使用遥控器

fetch 始终安全，因为它永远不会更改您的文件。如果您需要在变基后覆盖分支，请选择 --force-with-lease 而不是普通的 --force，因为它拒绝清除同事的新提交。

隐藏：把工作放在一边

当您需要切换任务但尚未准备好提交时，Stash 非常有用：

$ echo "wip" >> app.txt
$ git stash
$ git status --short
                       # clean, the change is put away
$ git stash pop
$ git status --short
 M app.txt

查看历史记录

撤消错误：“我想……”

这是大多数人查找的部分。找到你的情况：

重置、恢复、恢复

这三个名称引起很多混乱，但它们的作用却截然不同：

在我们的演示中，我们犯了一个错误的行并将其恢复。文件返回到其先前的内容，而错误在日志中作为历史记录保持可见：

$ echo "oops" >> app.txt
$ git commit -am "Bad change"
$ git revert --no-edit HEAD
$ cat app.txt
hello
login

然后 git reset --soft HEAD~1 删除了最后一次提交，但保留了其更改，git status --short 显示为 M app.txt。

标签

正如我们的 GitHub Actions CI/CD 指南 所解释的，标签通常会触发发布管道。

简单的日常工作流程

git switch main
git pull
git switch -c feature/search
# edit files
git status
git add -p
git commit -m "Add search by product name"
git push -u origin feature/search
# open a pull request, get a review, then merge

编写提交消息来解释命令中的更改，例如“修复登录重定向”。六个月后阅读日志时，您会感谢自己。

常见错误

• 提交机密。 在以后的提交中删除文件不会将其从历史记录中删除。立即旋转秘密，并使用.gitignore。
• 重写共享历史记录。 不要重置或变基其他人已经拉取的提交。
• 盲目使用git add .。首先检查git status，这样构建文件和日志就不会被影响。
• 使用普通--force。更喜欢--force-with-lease。
• 进行大量的提交。小的提交更容易审查、恢复和分割。

最后的话

学习这三个领域和十几个命令，Git 就不再那么可怕了。将撤消表放在手边，并记住 git status 和 git reflog 是您的安全网。为了建立信心，创建一个一次性存储库，并故意破坏和修复它，因为这是犯错误最便宜的地方。

常见问题

继续学习