Git 常用命令速查与分支操作指南

[!abstract] 摘要本文整理了 Git 日常高频命令的用法与分支管理的完整操作流程。面向二刷复习，注重快速上手和遗忘提醒。附带常见踩坑记录。
参考教程：CSDN Git 教程｜ B 站：黑马程序员 Git 全套教程

1. 基本命令（重要/易忘）#

1.1 `git init` — 初始化仓库#

作用：在当前目录创建 .git 子藏目录，使其成为一个 Git 仓库。

1
# 在当前目录初始化
2
git init
3

4
# 指定目录名初始化
5
git init my-project

提示

执行后当前目录下会多出一个隐藏的 .git 文件夹，不要手动修改或删除它，它是 Git 的”大脑”。

1.2 `git status` — 查看工作区状态#

作用：查看当前哪些文件被修改、暂存、未跟踪，是最常用的”侦察兵”命令。

1
git status
2

3
# 简洁模式（一目了然）
4
git status -s
5
# 输出示例：
6
# M  src/main.java    ← 已暂存（绿色 M 在左列）
7
#  M src/utils.java   ← 已修改未暂存（红色 M 在右列）
8
# ?? temp.txt         ← 未跟踪的新文件

状态标识速记

标识	含义
`??`	未跟踪（新文件）
`A`	新增到暂存区
`M`	已修改
`D`	已删除
`R`	重命名

1.3 `git log` — 查看提交历史#

作用：查看仓库的提交记录，默认按时间倒序。

1
# 基本查看
2
git log
3

4
# 单行简洁模式（最常用⭐）
5
git log --oneline
6

7
# 图形化分支结构（强烈推荐⭐⭐）
8
git log --oneline --graph --all
9

10
# 查看最近 N 条
11
git log -5
12

13
# 查看某文件的修改历史
14
git log -- path/to/file.java
15

16
# 搜索提交信息关键词
17
git log --grep="fix" --oneline

实用组合

习惯性使用 git log --oneline --graph --all，一张图看清所有分支的走向和合并情况。

1.4 `git reset` — 版本回退#

作用：将 HEAD 指针移动到指定提交，用于撤销提交或回退版本。

1
# 回退到某个 commit，修改保留在暂存区
2
git reset --soft <commit-hash>
3

4
# 回退到某个 commit，修改保留在工作区（默认模式）⭐最常用
5
git reset --mixed <commit-hash>
6
# 等价于
7
git reset <commit-hash>
8

9
# 回退到某个 commit，修改全部丢弃（慎用⚠️）
10
git reset --hard <commit-hash>
11

12
# 回退最近一次提交，保留修改在工作区
13
git reset HEAD~1

--hard 慎用

--hard 会彻底丢弃工作区和暂存区的修改，无法找回。不确定时优先用 --soft 或 --mixed。

三种模式对比：

模式	HEAD 指针	暂存区	工作区	适用场景
`--soft`	✅ 移动	❌ 不动	❌ 不动	合并多个提交为一个
`--mixed`	✅ 移动	✅ 重置	❌ 不动	撤销提交，重新挑选暂存
`--hard`	✅ 移动	✅ 重置	✅ 重置	彻底回退，丢弃所有修改

1.5 `git merge` — 合并分支#

作用：将指定分支的修改合并到当前分支。

1
# 将 feature 分支合并到当前分支
2
git merge feature
3

4
# 合并后有冲突？解决后继续
5
git merge --continue
6

7
# 放弃本次合并
8
git merge --abort

冲突解决流程：

执行 git merge 后出现 CONFLICT 提示
打开冲突文件，找到 <<<<<<< / ======= / >>>>>>> 标记
手动选择保留的内容，删除冲突标记
git add <冲突文件> → git commit

VSCode 用户

VSCode 会高亮显示冲突区域，并提供 “Accept Current” / “Accept Incoming” / “Accept Both” 的快捷按钮，解决后直接提交即可。

1.6 `git diff` — 查看差异#

作用：比较文件在不同状态之间的差异，日常排查修改利器。

1
# 工作区 vs 暂存区（未 add 的改动）
2
git diff
3

4
# 暂存区 vs 最新提交（已 add 但未 commit 的改动）
5
git diff --staged
6

7
# 比较两个分支的差异
8
git diff main..feature
9

10
# 只看文件名（不看具体差异）
11
git diff --name-only main..feature

2. 分支管理 ⭐#

2.1 `git branch` 基本操作#

1
# 查看所有本地分支
2
git branch
3

4
# 查看所有分支（含远程）
5
git branch -a
6

7
# 创建新分支
8
git branch feature
9

10
# 删除分支（已合并的）
11
git branch -d feature
12

13
# 强制删除分支（未合并也删）
14
git branch -D feature

2.2 分支切换与创建#

1
# 切换分支
2
git checkout feature
3
# 或新版写法（推荐⭐）
4
git switch feature
5

6
# 创建并切换到新分支
7
git checkout -b feature
8
# 或新版写法（推荐⭐）
9
git switch -c feature

switch vs checkout

git checkout 职责过多（切分支、恢复文件、切换 HEAD），Git 2.23+ 引入 switch 专门用于分支切换，语义更清晰。

2.3 合并分支 ⭐#

1
# 切回主分支，合并 feature
2
git switch main
3
git merge feature
4

5
# 合并后删除 feature 分支
6
git branch -d feature

合并策略示意：

1
# 快进合并（Fast-Forward）— feature 直接领先于 main
2
main ──●──●          main ──●──●──● (fast-forward)
3
              └──●    feature ─────┘
4

5
# 三方合并（3-Way Merge）— 双方都有新提交
6
main  ──●──●──┐
7
               ├──● (merge commit)
8
feature ──●──●─┘

2.4 同步远程分支 ⭐#

1
# 查看远程仓库信息
2
git remote -v
3

4
# 拉取远程最新代码（不合并）
5
git fetch origin
6

7
# 拉取并合并到当前分支
8
git pull origin main
9

10
# 推送本地分支到远程
11
git push origin main
12

13
# 首次推送并绑定上游分支⭐
14
git push -u origin main
15
# 后续直接 git push 即可

fetch vs pull

git fetch：只下载远程更新，不自动合并，安全可控
git pull = git fetch + git merge，一步到位但可能产生意外冲突

3. 踩坑记录#

3.1 绑定上游分支#

遇到 fatal: The current branch main has no upstream branch 报错时：

1
# 把本地 main 绑定到远程 study 仓库的 main 分支
2
git branch --set-upstream-to=study/main main

等价操作：首次推送使用 -u 参数：

1
git push -u study main

3.2 首次拉取无关历史报错#

fatal: refusing to merge unrelated histories — 两个仓库没有共同祖先时触发。

1
# 加 --allow-unrelated-histories 解决
2
git pull study main --allow-unrelated-histories
3

4
# 如果同时需要拉取标签
5
git pull study main --tags --allow-unrelated-histories

注意

此参数仅首次对接时需要，后续正常 pull 无需再加。

3.3 合并冲突处理#

VSCode 图形界面会高亮冲突区域
选择保留当前（Current）或传入（Incoming）的内容
确认后 git add . → git commit 提交合并结果

4. Tag 标签管理#

作用：标记版本节点（如 v1.0、正式版、里程碑），只读，不随代码频繁改动。

1
# 查看所有标签
2
git tag
3

4
# 创建轻量标签
5
git tag v1.0
6

7
# 创建附注标签（推荐⭐，包含作者和备注）
8
git tag -a v1.0 -m "第一个正式版本"
9

10
# 给历史提交打标签
11
git tag -a v0.9 abc1234
12

13
# 推送标签到远程
14
git push origin v1.0
15

16
# 推送所有标签
17
git push origin --tags
18

19
# 删除本地标签
20
git tag -d v1.0
21

22
# 删除远程标签
23
git push origin --delete v1.0

--tags 参数

git pull --tags 可以在拉取代码的同时拉取所有远程标签，常用于版本同步。

5. `.gitignore` 速查#

详见 → [[gitignore详解]]

1
# 快速模板
2
.idea/
3
.vscode/
4
node_modules/
5
dist/
6
*.log
7
.env

已跟踪文件的坑

已经 git add / git commit 过的文件，即使写入 .gitignore 也不会生效。需要先解除跟踪：

1
git rm -r --cached <文件或目录>
2
git commit -m "解除跟踪"

音乐

音乐

1. 基本命令（重要/易忘）#

1.1 `git init` — 初始化仓库#

1.2 `git status` — 查看工作区状态#

1.3 `git log` — 查看提交历史#

1.4 `git reset` — 版本回退#

1.5 `git merge` — 合并分支#

1.6 `git diff` — 查看差异#

2. 分支管理 ⭐#

2.1 `git branch` 基本操作#

2.2 分支切换与创建#

2.3 合并分支 ⭐#

2.4 同步远程分支 ⭐#

3. 踩坑记录#

3.1 绑定上游分支#

3.2 首次拉取无关历史报错#

3.3 合并冲突处理#

4. Tag 标签管理#

5. `.gitignore` 速查#

支持与分享

音乐

文章目录

音乐

音乐

Git 常用命令速查与分支操作指南

1. 基本命令（重要/易忘）#

1.1 git init — 初始化仓库#

1.2 git status — 查看工作区状态#

1.3 git log — 查看提交历史#

1.4 git reset — 版本回退#

1.5 git merge — 合并分支#

1.6 git diff — 查看差异#

2. 分支管理 ⭐#

2.1 git branch 基本操作#

2.2 分支切换与创建#

2.3 合并分支 ⭐#

2.4 同步远程分支 ⭐#

3. 踩坑记录#

3.1 绑定上游分支#

3.2 首次拉取无关历史报错#

3.3 合并冲突处理#

4. Tag 标签管理#

5. .gitignore 速查#

支持与分享

音乐

文章目录

1.1 `git init` — 初始化仓库#

1.2 `git status` — 查看工作区状态#

1.3 `git log` — 查看提交历史#

1.4 `git reset` — 版本回退#

1.5 `git merge` — 合并分支#

1.6 `git diff` — 查看差异#

2.1 `git branch` 基本操作#

5. `.gitignore` 速查#