速查 Git 常用的命令和用法。分为基本（commit、branch、checkout、merge、rabase 等）和远程（clone、push、pull 等）两部分。

本文基于 chatGPT 自动生成初稿（省时省力😁），并参考 learngitbranching 进行调整。

基本命令

git init：创建一个新的 Git 仓库。

git add [file]：将文件添加到 Git 的暂存区。

git commit -m [message]：将暂存区的文件提交到 Git 仓库，并添加一条注释。

git status：查看当前 Git 仓库的状态，包括已修改、已暂存和未跟踪的文件。

git diff：查看未暂存文件和最后一次提交之间的差异。

git diff --staged：查看已暂存文件和最后一次提交之间的差异。

git log：查看 Git 仓库的提交历史。

git reflog：查看命令历史，即分支的所有操作记录。

git tag [name]：给当前的提交打上标签。

git reset：取消暂存或取消上一次提交。

git rm [file]：从 Git 仓库中删除文件。

分支相关

git branch [name]：创建一个新的分支。

git branch -d[D] [name]：删除[强制删除]一个分支。

git checkout [branch-name]：切换到另一个分支。

git checkout -b [branch-name]：创建同时切换到另一个分支。

git merge [branch]：将指定的分支合并到当前分支。

git rebase [branch]：将当前分支的提交步骤顺接到指定分支。

远程相关

git clone [url]：从远程仓库克隆一个副本到本地。

git pull：从远程仓库拉取最新的代码到本地。

git push [origin] [master]：将本地 master 分支推送到远程仓库。

git remote -[v] 查看远程仓库[详细]信息。

git remote add [name] [url]：将远程仓库添加到 Git 仓库。

git fetch：从远程仓库获取最新的代码，但不进行合并。先fetch，再merge就相当于pull。

其他

HEAD：指向当前正在处理的提交记录。

C^[number]：表示指向提交记录 C 的第 number 个直接父记录（宽度搜索）。一个记录可能会有多个父记录（执行 merge 时产生）。C^ 和 C^1 等价；number大于 1 时表示指向其他父记录。

C~[number]：表示指向提交记录 C 的回溯第 number 代的祖先记录（深度搜索）。

参考

• [1] Peter Cottle. learngitbranching. https://learngitbranching.js.org/?locale=zh_CN
• [2] GitHub Docs. Git Cheat Sheets. https://training.github.com/downloads/zh_CN/github-git-cheat-sheet/
• [3] Visual Git Cheat Sheet. https://ndpsoftware.com/git-cheatsheet.html
• [4] Blue Stragglers. 一个有趣的 Git 练习网站. https://zhuanlan.zhihu.com/p/383960650

更多 git 知识和用法

git 本地仓库文件夹结构

在 git repo 文件夹下，命令行执行 git init 初始化后，会生成一个 .git 文件夹，里面包含以下内容：

• .git/HEAD：指向当前分支
• .git/config：配置文件
• .git/description：描述文件
• .git/index：索引文件
• .git/hooks/：钩子脚本
• .git/info/：包含全局忽略文件
• .git/objects/：存储对象（commit、tree、blob）
• .git/refs/：存储引用（branch、tag）
• .git/logs/：存储提交日志

一般来说，.git 文件夹自动隐藏了，Power Shell 可以通过 ls -Hidden 命令查看。

git 中的一些概念

对象（名词）

• commit：提交，每次提交都会生成一个 commit id，commit id 是一个 40 位的哈希值，用来唯一标识一个 commit。
• tree：树，每个 commit 都有一个 tree，用来存储该 commit 修改的文件和目录结构。
• blob：块，每个文件都会被存储为一个 blob，用来存储文件的内容。
• branch：分支，每个分支都有一个指向最新的 commit 的指针。
• tag：标签，用来标记某个 commit，通常用来标记 release 版本。
• HEAD：当前分支的指针，指向当前分支的最新 commit。
• index：索引，用来存储暂存区的文件。
• remote：远程仓库，用来存储远程的 git 仓库。

origin 远程仓库别名

• origin：远程仓库的别名，通常用来表示远程仓库。可以把它看作是远程仓库的“默认地址”。 在 Git 中，origin 是一个默认的远程仓库名称，它通常指向你克隆时指定的远程仓库。简单来说，origin 代表远程仓库的默认别名。你可以把它看作是远程仓库的“默认地址”。

1. 默认远程仓库名称：

   • 当你克隆一个仓库时，Git 会自动把源仓库的 URL 赋给一个默认的远程名称 origin。
   • 例如，执行 git clone https://github.com/user/repo.git 后，origin 就会指向该 URL。

2. 查看远程仓库地址：

   • 你可以通过以下命令查看 origin（以及其他远程仓库）的 URL：

     bash

     git remote -v

     输出示例：

     bash

     origin  https://github.com/user/repo.git (fetch)
     origin  https://github.com/user/repo.git (push)

3. 常见的 origin 用法：

   • git fetch origin：从 origin 获取远程更新。
   • git push origin <branch-name>：将本地的某个分支推送到 origin 上。
   • git pull origin <branch-name>：从 origin 拉取并合并远程分支到当前分支。

4. 修改远程仓库名称：

   • 如果你想给远程仓库指定不同的名称（除了 origin），可以使用 git remote rename 命令：

     bash

     git remote rename origin new-remote-name

5. origin 只是一个名字：

   • origin 只是一个约定俗成的名称，你完全可以把它改为其他名字。如果你与多个远程仓库交互，可以给每个远程仓库取不同的名字，例如 upstream 或 myfork，这样有助于区分不同的远程仓库。

总之，origin 是 Git 中的一个默认远程仓库别名，用于简化与远程仓库的交互。

操作（动词）

• push：推送，将本地的 commit 推送到远程仓库。
• pull：拉取，从远程仓库拉取最新的 commit。
• merge：合并，将两个分支的 commit 合并成一个 commit。
• rebase：变基，将一个分支的 commit 变基到另一个分支上。
• reset：重置，将暂存区和工作区重置到指定的 commit。
• checkout：检出，将工作区切换到指定的 commit。

git 基本命令

• git init：初始化 git 仓库

• git add <file>...：添加文件到暂存区

• git add . 或 git add -A：添加所有文件到暂存区

• git status：查看当前 git 状态

• git diff：查看暂存区与工作区的差异
• git diff --cached：查看暂存区与本地仓库的差异
• git diff HEAD：查看工作区与本地仓库的差异
• git diff <commit>：查看工作区与指定 commit 的差异
• git diff <commit> <commit>：查看两个 commit 之间的差异
• git diff <branch>：查看工作区与指定 branch 的差异
• git diff <branch> <branch>：查看两个 branch 之间的差异
• git diff <commit> <branch>：查看 commit 与 branch 之间的差异
• git diff <commit> <commit> <branch>：查看两个 commit 与 branch 之间的差异
• git diff <commit> <commit> <commit>：查看三个 commit 之间的差异

• git rm <file>：删除文件
• git mv <file> <file>：移动文件
• git rm --cached <file>：删除暂存区的文件
• git mv --cached <file> <file>：移动暂存区的文件

• git reset：重置暂存区
• git reset --hard：重置暂存区和工作区
• git reset --soft：重置暂存区，保留工作区
• git reset --mixed：重置暂存区和工作区，保留 commit
• git reset --hard <commit>：重置暂存区和工作区到指定 commit
• git reset --soft <commit>：重置暂存区到指定 commit，保留工作区
• git reset --mixed <commit>：重置暂存区和工作区到指定 commit，保留 commit
• git reset --hard HEAD~1：重置暂存区和工作区到上一个 commit
• git reset --hard HEAD^^：重置暂存区和工作区到上两个 commit
• git reset --hard HEAD~n：重置暂存区和工作区到上 n 个 commit
• 撤销提交后恢复（git reset、git commit --amend、git revert等方式撤销/修改了原来的提交）
• 1. git log：查看提交日志，找到需要恢复的 commit id
• 2. git reset --hard <commit_id>：重置暂存区和工作区到指定 commit
• 3. git reflog：查看引用日志，找到需要恢复的 commit id。Git 的 reflog 记录了仓库中 HEAD 和分支头的变动历史。即使提交被撤销，它们仍然被记录在 reflog 中，只要它们还在 Git 的数据库中。
• 4. git reset --hard <commit_id>：重置暂存区和工作区到指定 commit

• git commit -m "commit message"：提交暂存区的文件到本地仓库
• git commit：提交暂存区的文件到本地仓库
• git commit --amend：修改最近一次提交的 commit message

• git log：查看提交日志，展示每次提交的 commit id、commit message、commit author、commit date
• git log --oneline：查看提交日志（简洁），展示每次提交的 commit id 和 commit message
• git log --graph：查看提交日志（图形化），展示提交树
• git log --stat：查看提交日志（统计），展示每次提交的修改文件和修改数
• git log --pretty=format:"%h - %an, %ar : %s"：查看提交日志（自定义格式），展示每次提交的 commit id、commit author、commit date 和 commit message
• git log --pretty=format:"%h - %an, %ar : %s" --graph：查看提交日志（自定义格式+图形化），展示每次提交的 commit id、commit author、commit date 和 commit message
• git log <branch>：查看指定分支的提交日志

• git tag：查看所有标签
• git show <tagname>：查看标签信息
• git tag <tagname>：创建轻量标签
• git tag <tagname> <commit_hash>：为指定 commit 创建标签
• git tag -a <tagname> -m "tag message"：创建带有描述的标签
• git tag -d <tagname>：删除本地标签
• git push origin <tagname>：推送标签到远程仓库。标签默认旨在本地仓库存在。
• git push origin --tags：推送所有标签到远程仓库
• 删除远程标签步骤
• 1. 删除本地标签：git tag -d <tagname>
• 2. 删除远程标签：git push origin --delete tag <tag_name>
• 3. 验证是否删除：git ls-remote --tags origin

• git merge <branch>：合并指定 branch 到当前 branch
• git merge --no-ff <branch>：合并指定 branch 到当前 branch，不使用 fast-forward
• git merge --squash <branch>：合并指定 branch 到当前 branch，将所有 commit 合并为一个 commit
• git merge --no-commit <branch>：合并指定 branch 到当前 branch，不自动提交
• git merge --abort：取消合并，回到合并前的状态
• git merge --continue：继续合并，解决冲突后继续合并，解决冲突后需要手动提交
• git merge --ff-only <branch>：合并指定 branch 到当前 branch，只使用 fast-forward
• git merge --no-ff --no-commit <branch>：合并指定 branch 到当前 branch，不使用 fast-forward，不自动提交
• git merge --no-ff --squash <branch>：合并指定 branch 到当前 branch，不使用 fast-forward，将所有 commit 合并为一个 commit
• git merge --no-ff --no-commit --squash <branch>：合并指定 branch 到当前 branch，不使用 fast-forward，不自动提交，将所有 commit 合并为一个 commit

• git rebase <branch>：将当前 branch 的提交应用到指定 branch 上，保留指定 branch 的提交
• git rebase --onto <branch> <branch>：将当前 branch 的提交应用到指定 branch 上，忽略指定 branch 的提交
• git rebase --interactive <branch>：交互式 rebase，可以修改、删除、合并提交

• git branch：查看当前分支
• git branch <branch>：创建分支
• git branch -d <branch>：删除分支
• git branch -D <branch>：强制删除分支
• git branch -m <branch>：重命名分支
• git branch -M <branch>：强制重命名分支
• git branch -r：查看远程分支
• git branch -a：查看所有分支
• git branch -vv：查看本地分支与远程分支的关联
• git branch -u <remote>/<branch>：设置本地分支与远程分支的关联
• git branch -d -r <remote>/<branch>：删除远程分支
• git branch -D -r <remote>/<branch>：强制删除远程分支 重命名远程分支
• git branch -m <old-branch> <new-branch>：重命名本地分支
• git branch -M <old-branch> <new-branch>：强制重命名本地分支

• git checkout <branch>：切换分支
• git checkout -b <branch>：创建并切换分支
• git checkout -B <branch>：强制创建并切换分支
• git checkout <commit>：切换到指定 commit，即将 HEAD 指向这个commit。会提示 detached HEAD 警告，因为此时 HEAD 不再指向任何分支，而是指向一个具体的 commit。此时可以进行任意修改，但不会影响其他分支。如果需要创建一个新的分支来保存这些修改，可以使用 git switch -c <new-branch-name> 命令。
• git checkout <file>：恢复工作区文件到指定 commit
• git checkout -- <file>：恢复指定工作区文件到暂存区。用来放弃掉所有还没有加入到缓存区（就是 git add 命令）的修改，但是此命令不会删除掉刚新建的文件。因为刚新建的文件还没已有加入到 git 的管理系统中。所以对于git是未知的。手动删除即可。
• git checkout -- .：恢复工作区所有文件到暂存区。
• git checkout -p <branch>：比较当前分支与指定分支的差异
• git checkout -p <commit>：比较当前分支与指定 commit 的差异
• git checkout -p <file>：比较当前分支与指定文件的差异

• git switch <branch>：切换分支
• git switch -c <branch>：创建并切换分支
• git switch -C <branch>：强制创建并切换分支
• git switch --detach <branch>：切换到指定分支，并将 HEAD 指向这个分支
• git switch --create <branch>：创建并切换分支

远程仓库操作

• git clone <repository>：克隆远程仓库
• git clone <repository> <directory>：克隆远程仓库到指定目录
• git clone --depth <depth> <repository>：克隆远程仓库，只克隆最近 depth 个 commit
• git clone --branch <branch> <repository>：克隆远程仓库的指定分支
• git clone --single-branch <repository>：克隆远程仓库的单个分支
• git clone --mirror <repository>：克隆远程仓库的镜像
• git clone --bare <repository>：克隆远程仓库的裸仓库
• git clone --depth <depth> --branch <branch> <repository>：克隆远程仓库的指定分支，只克隆最近 depth 个 commit
• git clone --depth <depth> --single-branch <repository>：克隆远程仓库的单个分支，只克隆最近 depth 个 commit
• git clone --depth <depth> --mirror <repository>：克隆远程仓库的镜像，只克隆最近 depth 个 commit
• git clone --depth <depth> --bare <repository>：克隆远程仓库的裸仓库，只克隆最近 depth 个 commit

• git remote -v：查看远程仓库

• git remote add <name> <url>：添加远程仓库

• git remote remove <name>：删除远程仓库

• git remote rename <old-name> <new-name>：重命名远程仓库

• git remote set-url <name> <url>：设置远程仓库的 URL

• git remote set-url --add <name> <url>：添加远程仓库的 URL

• git remote set-url --delete <name> <url>：删除远程仓库的 URL

• git remote update <name>：更新远程仓库

• git remote prune <name>：删除远程仓库中已经不存在的分支

• git remote show <name>：查看远程仓库的信息

• git remote set-head <name> <branch>：设置远程仓库的默认分支

• git remote set-branches <name> <branch>：设置远程仓库的分支

• git fetch <name>：获取远程仓库的所有分支

• git fetch <name> <branch>：获取远程仓库的指定分支

• git push <name> <branch>：将当前分支推送到远程仓库的指定分支

• git push <name> <branch>:<branch>：将当前分支推送到远程仓库的指定分支，并重命名远程分支

• git push -u <name> <branch>：将当前分支推送到远程仓库的指定分支，并设置远程仓库的默认分支

• git push origin --delete <branch>：删除远程仓库的指定分支

• git push --set-upstream origin <branch>：设置远程仓库的默认分支

• git pull <name> <branch>：获取远程仓库的指定分支，并合并到当前分支

• git pull --set-upstream origin <branch>：获取远程仓库的指定分支，并设置远程仓库的默认分支