在日常编写代码或撰写文档时,如果没有专门的版本管理工具,维护历史版本通常只能靠手动复制整个文件夹,例如按时间命名成 project_v1、project_v2_final、project_v2_fixed。这种做法很快会暴露出三个问题:每次改动都要拷贝整套文件导致硬盘空间浪费;几周之后很难再查清两个副本之间具体修改了哪几行;多人同时修改同一批文件时,直接覆盖文件夹极易造成彼此的修改丢失。
Git 正是为了解决上述问题而设计的本地版本控制系统。这里需要先理清一个初学者最常混淆的概念——Git 与 GitHub 的区别:Git 是安装在自己电脑上的版本管理软件,不需要连接互联网,就可以在本地完整记录和回溯每一次代码改动;而 GitHub(或 GitLab、Gitee)则是搭建在互联网服务器上的代码托管网站,专门用来存放和备份本地的 Git 仓库,方便多人协同开发。即使只用本地电脑单人开发,Git 也已经能够发挥完整作用。
本章面向从未运行过 Git 命令的读者,自顶向下走完一套最基础的本地使用闭环:如何完成首次身份配置并建立仓库、如何通过 git status、git add 与 git commit 保存第一个版本、修改代码后如何用 git diff、git log 和 git show 核对变化与历史,以及如何用 .gitignore 过滤不该纳入版本管理的文件。
git config 与 git init安装好 Git 之后,在正式保存第一个版本之前,需要先执行一次全局身份配置。因为 Git 记录每一次代码提交时,都会把“是谁做的修改”以及“联系方式”写进版本历史里;如果不提前配置,首次提交会被系统拦截提示输入身份信息。在终端运行以下两条命令即可完成一次性配置(全局只需设置一次):
git config --global user.name "Alice"
git config --global user.email "alice@example.com"
接下来新建一个空目录,并把它初始化为 Git 仓库:
mkdir demo-app && cd demo-app
git init
终端会输出 Initialized empty Git repository in .../demo-app/.git/。此时从操作系统看来,demo-app 依然是一个普通文件夹,唯一的变化是里面多出了一个隐藏子目录 .git。所有关于历史版本、提交说明和跟踪记录的数据都保存在 .git 内部;如果有一天不再需要该项目的版本历史,删掉 .git 目录就会把它还原回普通文件夹,当前源码文件本身不会受损。
git status、git add 与 git commit为了直观体会 Git 如何追踪文件变化,先看清一个普通文件在 Git 管理下经历的四种基本状态。
图 1:文件在本地项目目录中的四种状态转换路径。git status 用于实时查询文件当前所处的状态。
现在按实际操作顺序走一遍创建文件到保存第一版的完整过程。首先在 demo-app 目录内新建一个 app.py 文件,内容如下:
def greet():
return "Hello"
git status 查看当前状态在终端运行 git status,可以看到类似下面的提示:
On branch main
No commits yet
Untracked files:
(use "git add <file>..." to include in what will be committed)
app.py
nothing added to commit but untracked files present (use "git add" to track them)
其中 Untracked files(未跟踪文件)表示 Git 已经看到了文件夹里新建的 app.py,但这个文件目前还不归 Git 管理——Git 不会自作主张把文件夹里出现的每个文件都塞进历史版本里,必须由你明确指定。
git add 把文件放进待提交清单运行下面的命令将 app.py 加入待提交清单(在 Git 中称为“暂存”):
git add app.py
这里有一个常用扩展写法:如果一次新建或修改了多个文件,可以运行 git add .(注意后面有一个点号),表示把当前目录下所有新出现或已修改的文件一次性全部加入待提交清单;但在包含临时脚本时,使用 git add <具体文件名> 精准挑选更为稳妥。执行完 git add app.py 后,再次运行 git status 确认状态变化:
Changes to be committed:
(use "git rm --cached <file>..." to unstage)
new file: app.py
app.py 此刻已经进入“已暂存(Staged)”状态,出现在 Changes to be committed 清单之下,等待正式保存。
git commit 正式保存版本确认待提交清单无误后,运行提交命令生成项目的第一个历史版本:
git commit -m "feat: add initial greeting function"
命令中的 -m 参数用来附加一句简洁的提交说明(Commit Message),记录这次改了什么功能、为什么改,方便未来几个月后回看历史。如果忘记加 -m,Git 会自动在终端打开默认文本编辑器(如 Vim)等待你输入说明,许多初学者会在这里被卡住,因此日常操作建议直接带上 -m "..."。提交成功后,终端输出如下摘要:
[main (root-commit) 4ecd02b] feat: add initial greeting function
1 file changed, 2 insertions(+)
这行提示表明:Git 已经在默认分支 main 上记录了初始提交(编号短写为 4ecd02b),本次共有 1 个文件变动、新增了 2 行内容。至此,app.py 进入“已提交(Committed)”状态,这个版本已经被永久写入 .git 目录中。
git diff、git log 与 git show软件开发是不断迭代的过程。现在打开 app.py,把返回值修改为 "Hello, Git" 并保存文件。此时再次执行 git status:
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
modified: app.py
输出中的 modified: app.py 对应图 1 中的第四种状态“已修改(Modified)”,它位于 Changes not staged for commit 下方,意思是 Git 检测到已经纳入管理的文件发生了变化,但这份新改动还没有执行 git add 放进下一次的待提交清单。
在决定提交之前,通常需要核对一下刚才具体改了哪几行。运行 git diff 即可查看行级差异:
--- a/app.py
+++ b/app.py
@@ -1,2 +1,2 @@
def greet():
- return "Hello"
+ return "Hello, Git"
看懂这段差异输出只需要注意三点:--- a/app.py 代表修改前的旧内容,+++ b/app.py 代表修改后的新内容;以减号 - 开头且通常标红的行表示被删掉或替换掉的旧行,以加号 + 开头且通常标绿的行表示新写入的内容。
这里有一个极易困惑的细节:当你紧接着执行 git add app.py 后,如果再运行一次 git diff,终端会没有任何输出。原因在于 git diff 默认对比的是“硬盘上的最新文件”和“暂存区待提交清单”之间的差异;一旦你执行了 git add,两者内容就已经完全一致了。若想查看“已经放入暂存区清单、准备提交的改动”与上一个正式版本之间的差别,需要加上 --staged 参数,运行 git diff --staged。
图 2:修改文件之后、执行 git add app.py 之后以及执行 git diff --staged 时,工作区、暂存区与 HEAD 最新提交之间的状态变化与命令对比范围。
核对无误后,执行 git commit -m "feat: update greeting text" 生成第二个版本。现在本地已经有了两次历史记录,可以通过查看历史的常用命令随时检索:
git log:按从最新到最旧的顺序,完整列出每一次提交的 40 位唯一编号、所属分支标记(例如 HEAD -> main)、作者、提交时间与提交说明。当提交记录较多、一屏装不下时,终端会进入分页浏览模式,按键盘上的 q 键即可退出返回命令行。运行后的输出格式如下:
commit 7b3f686c2d... (HEAD -> main)
Author: Alice <alice@example.com>
Date: Mon Nov 16 18:35:00 2026
feat: update greeting text
commit 4ecd02b8a1...
Author: Alice <alice@example.com>
Date: Mon Nov 16 18:30:00 2026
feat: add initial greeting function
git log --oneline:把每次提交压缩成一行显示,仅保留前 7 位短编号与提交说明,适合快速浏览整体演进清单。
git show <7位短编号>:查看某一个特定历史版本的详细情况,例如运行 git show 4ecd02b,不仅会展示这次提交的作者与说明,还会一并打印出该版本当年具体增删了哪些代码行。
.gitignore一个真实的工程文件夹里,并不是所有文件都适合提交进版本库。例如保存数据库密码和 API 密钥的 .env 文件一旦提交就会泄露敏感凭据;操作系统自动生成的目录缓存文件(如 macOS 下的 .DS_Store)会干扰其他系统上的协作者;前端的 node_modules/ 或 Python 的 .venv/、__pycache__/ 体积动辄数百 MB 且随时可以通过依赖清单文件重新生成,放进版本库只会让仓库异常臃肿。
为了防止自己或同事在执行 git add . 时误把这些文件加进版本库,只需在项目根目录创建一个名为 .gitignore 的纯文本文件,逐行写明需要忽略的文件名、扩展名通配符或目录名:
.env
.DS_Store
*.log
node_modules/
.venv/
__pycache__/
配置好 .gitignore 后,上述路径下的文件在运行 git status 时会自动被隐藏,执行 git add . 也会主动跳过它们。顺便把 .gitignore 文件本身执行一次 git add .gitignore 与 git commit 存进仓库,团队所有成员拉取代码后就都能共享同一套过滤规则。
需要注意一条关键生效条件:.gitignore 只对当前尚未被 Git 跟踪的文件有效。如果此前你不小心已经把 .env 执行过 git add 和 git commit 提交进了历史版本,哪怕后来再把 .env 写进 .gitignore,Git 依然会继续追踪它的后续修改。此时的修正方法是从跟踪清单中移出该文件但保留本地硬盘上的实体文件:
git rm --cached .env
git commit -m "chore: stop tracking .env file"
--cached 参数告诉 Git 只从版本库索引里取消管理,不要把硬盘上的 .env 文件删掉。执行上述提交后,.gitignore 对 .env 的过滤规则就会立即生效。
掌握了 init、status、add、commit、diff、log、show 与 .gitignore 这套核心基础命令后,下一章将从命令表象再往下走一步,拆解 Git 为什么要把保存分成三个区域、提交的本质究竟是补丁还是全量快照,以及 .git 目录内部如何高效地保存成千上万个版本。