2.0 本节命令行汇总#

1
git init                                   # 创建本地 Git 仓库
2
git add <file>                             # 暂存指定文件
3
git add .                                  # 暂存所有变更文件
4
git commit -m "message"                    # 提交变更，message 为提交说明
5
git log                                   # 查看提交历史
6
git log --pretty=oneline --graph          # 以单行图形化方式查看提交历史

2.1 创建本地仓库#

在 Git 中，本地仓库本质上就是项目根目录下的 .git 目录。通过 git init 命令可以在任意目录中初始化一个新的 Git 仓库。

以一个空项目为例。

在项目根目录下执行初始化命令：

1
git init

执行成功后，项目目录中会生成一个 .git 文件夹，其中包含了仓库的所有版本记录和配置信息。可以理解为：.git 目录 = Git 仓库。

2.2 文件的四种状态#

在 Git 中，文件共有四种状态。理解这四种状态是掌握 Git 工作流程的关键。

状态流转关系：

• Untracked → Staged：执行 git add，添加文件到暂存区
• Unmodified → Modified：编辑文件内容，变为已修改状态
• Modified → Staged：执行 git add，将修改内容加入暂存区
• Staged → Unmodified：执行 git commit，提交后仓库记录更新，文件回到未修改状态
• Unmodified → Untracked：通过 .gitignore 或删除跟踪操作，使文件回到未跟踪状态

2.3 首次提交#

初始化仓库后，通常需要先进行一次提交来建立版本基线。

暂存文件：

1
git add README.md

git add 命令将指定文件加入暂存区。如果需要暂存所有文件，可以使用 git add .。

提交文件：

1
git commit -m "first commit"

git commit 将暂存区中的内容提交到本地仓库。-m 参数后跟本次提交的说明信息。

首次提交完成后，文件状态会从 Staged 回到 Unmodified。

2.4 提交信息规范#

在团队协作中，统一的提交信息格式有助于代码审查和版本回溯。推荐使用以下规范格式：

1
verb(range): detail

• verb：动作动词，表示本次提交的操作类型
• range：影响范围或模块，用英文括号包裹
• detail：具体的提交描述内容

常用动词示例如下：

2.5 查看提交记录#

提交完成后，可以使用 git log 命令查看仓库的提交历史。

基础用法：

1
git log

输出结果示例：

1
commit 7a89f743412273876184f0da11974d1e866a3114 (HEAD -> master)
2
Author: your_name <your_email@example.com>
3
Date:   Wed Apr 29 22:13:33 2026 +0800
4

5
    edit(docs): README.md
6

7
commit 64a2b2accc0afa7c5419f79286892e8163407114
8
Author: your_name <your_email@example.com>
9
Date:   Wed Apr 29 21:16:09 2026 +0800
10

11
    first commit

每条记录包含提交哈希值、作者信息、提交时间和提交说明。

格式化查看：

1
git log --pretty=oneline --graph

使用 --pretty=oneline 将每条提交压缩为一行显示，--graph 以可视化方式展示分支结构。

输出结果示例：

1
* 7a89f743412273876184f0da11974d1e866a3114 (HEAD -> master) edit(docs): README.md
2
* 64a2b2accc0afa7c5419f79286892e8163407114 first commit

2.6 本节小结#

本节完成了以下内容：

• 学习了使用 git init 创建本地仓库的方法
• 理解了文件的四种状态（Untracked、Unmodified、Modified、Staged）及其流转关系
• 掌握了首次提交的完整流程（命令行与 VS Code 图形化操作）
• 了解了提交信息的规范格式与常用动词
• 学会了使用 git log 查看提交记录

下一节我们将学习分支的创建与管理。