第三章：第一个 Git 仓库

← 上一章：安装与配置 | 返回目录 | 下一章：连接远程仓库 →

这一章我们来动手实操，完成你人生中第一个 Git 仓库的创建和提交。

3.1 创建本地仓库

第一步：创建一个项目文件夹

你可以在任何位置创建。打开终端，输入：

mkdir my-first-project
cd my-first-project

mkdir 是创建文件夹的命令，cd 是进入文件夹的命令。

第二步：初始化 Git 仓库

git init

你会看到类似这样的输出：

Initialized empty Git repository in /xxx/my-first-project/.git/

恭喜！这个文件夹现在已经是一个 Git 仓库了。Git 在里面创建了一个隐藏的 .git 文件夹，所有的版本信息都存在这里面。

千万不要手动删除或修改 .git 文件夹，否则所有历史记录都会丢失。

3.2 Git 的基本工作流（最核心的三步）

接下来我们要学习 Git 最最最核心的三个命令，你每天都会用到它们：

第一步：创建/编辑文件

在项目文件夹中创建一个文件。你可以用任何编辑器，也可以用命令行：

echo "Hello Git! 这是我的第一个项目。" > README.md

这条命令会创建一个名为 README.md 的文件，内容是引号里的文字。

第二步：添加到暂存区（git add）

git add README.md

这条命令的意思是：“我准备好了，把这个文件放入待提交区域。”

如果你修改了多个文件，不想一个个添加，可以用：

git add .

. 表示”当前目录下的所有文件”，这是最常用的方式。

第三步：提交到本地仓库（git commit）

git commit -m "初始化项目，添加README文件"

-m 后面的引号里是提交说明，用简短的文字描述你这次做了什么改动。

输出类似：

[main (root-commit) a1b2c3d] 初始化项目，添加README文件
 1 file changed, 1 insertion(+)
 create mode 100644 README.md

三步总结

编辑文件  →  git add .  →  git commit -m "说明"
  (写)        (暂存)           (提交)

每完成一个小功能或修改，就重复这三步。 这是使用 Git 的基本节奏。

3.3 查看状态与历史

git status —— 查看当前状态

在任何时候，你都可以用这个命令看看仓库的情况：

git status

场景一：刚提交完，所有文件都已提交

On branch main
nothing to commit, working tree clean

意思是”一切都好，没有需要提交的改动”。

场景二：修改了文件但还没 add

On branch main
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
        modified:   README.md

意思是”README.md 被改过了，但还没放到暂存区”。

场景三：新建了文件还没 add

On branch main
Untracked files:
  (use "git add <file>..." to include in what will be committed)
        app.py

意思是”有一个新文件 app.py，Git 还不认识它”。

git log —— 查看提交历史

git log

输出示例：

commit a1b2c3d4e5f6g7h8i9j0 (HEAD -> main)
Author: 张三 <zhangsan@example.com>
Date:   Mon Mar 30 10:00:00 2026 +0800

    初始化项目，添加README文件

每条记录包含：提交的唯一 ID（一长串字符）、作者、时间、提交说明。

如果觉得信息太多，用精简模式：

git log --oneline

输出：

a1b2c3d 初始化项目，添加README文件

git diff —— 查看文件改动

当你修改了文件但还没 add 时，可以用 git diff 查看具体改了什么：

git diff

输出会用 + 和 - 标记新增和删除的内容：

- Hello Git! 这是我的第一个项目。
+ Hello Git! 这是我的第一个项目。我学会了 Git！

3.4 动手练习

请跟着下面的步骤完整操作一遍：

# 1. 创建项目并初始化
mkdir git-practice
cd git-practice
git init

# 2. 创建第一个文件并提交
echo "# 我的练习项目" > README.md
git add .
git commit -m "第一次提交：添加README"

# 3. 修改文件
echo "这个项目用来练习 Git" >> README.md

# 4. 查看改动
git diff

# 5. 查看状态
git status

# 6. 提交修改
git add .
git commit -m "第二次提交：补充项目说明"

# 7. 创建新文件并提交
echo "print('Hello World')" > app.py
git add .
git commit -m "第三次提交：添加app.py"

# 8. 查看提交历史
git log --oneline

你应该会看到三条提交记录，从下到上按时间排列。

恭喜！你已经学会了 Git 最核心的操作。 后面的章节都是在这个基础上扩展的。

← 上一章：安装与配置 | 返回目录 | 下一章：连接远程仓库 →