Git 心智模型与第一次提交

Git 是什么,和 GitHub 什么关系

git 是装在本机的程序。它把每次提交写进当前目录下的 .git, 不联网、不登录也能提交、看历史、比差异。

GitHub 是一个网站,负责托管 .git 里那些提交,让别人能拉下来。 没有 GitHub,git 照常工作,只是少了一份共享副本。

git

GitHub

装在哪

你的机器

别人的服务器

存什么

全部历史,压缩后的对象

同一批提交和对象

断网能用吗

能

不能

git 把整个仓库镜像到本地,包括完整的历史记录。 git clone 拉的是全部版本,不是最新那一份;服务端磁盘坏了,任何一个克隆都能把它重建出来。

本课全程离线,用不到 GitHub。它只作为第四个位置出现在下一节,具体操作在第 4 课。

给个正式说法:Git 是分布式版本控制系统,管的是文件的历史 —— 每一次改动记成一个可回退的快照, 分支与协作都建在这个快照库上。

「版本控制」指那套快照机制本身;「分布式」指每个人手里都有一整份历史,不连服务器也能提交、看日志、比差异。

GitHub 是一个基于 Git 的代码托管平台,托管这份历史、让多人围着它协作;它不给 Git 增加任何能力。

安装与配置

装完先确认版本号,后面的输出格式以它为准。

git --version git version 2.52.0.windows.1

如果没有版本显示,说明没有安装 git 或者路径环境失效。可通过以下方式重新安装:

winget install --id Git.Git -e --source winget # 如果是Windows
sudo apt install git # 如果是Ubuntu/Debian

首次可以配置全局GitHub账号。不过目前常用的是token来认证。

git config --global user.name "Zhang San" #用户名 git config --global user.email "zhangsan@example.com" #邮箱

--global 写进用户目录的 .gitconfig,对所有仓库生效;去掉之后只在当前仓库写入账号 .git/config。 查一下确实写进去了:

git config user.name Zhang San

没有登录的情况下无法提交到远程仓库

添加3条默认值

git config --global init.defaultBranch main #设置默认分支名为 main git config --global core.quotepath false #设置中文文件名显示为中文 git config --global core.autocrlf true #设置自动转换行尾

使你的工作目录git化,实现版本控制

空目录开始。

mkdir gitdemo # 创建一个空目录 cd gitdemo #进入文件夹 git init #重要一步,初始化项目,git会在当前目录下创建一个.git的隐藏文件夹,里面存放着所有的版本信息 Initialized empty Git repository in D:/lab/gitdemo/.git/

最后一行是 git init 在告诉你仓库建在哪。目录里除了多出来的 .git 什么都没有, 此时 git 还不认识任何文件。

git status #当前状态 On branch main #在main分支 No commits yet #无任何提交 nothing to commit (create/copy files and use "git add" to track)

在项目文件夹里面新建 app.txt,内容随便写一行:version=1。

git status On branch main No commits yet Untracked files: #这里就和上次不一样了,多一行,说明git看见了这个文件 (use "git add <file>..." to include in what will be committed) app.txt nothing added to commit but untracked files present (use "git add" to track)

Untracked files 是「git 看见了这个文件,但不打算管」。

将txt文件添加到暂存区:

git status -s #简短状态 ?? app.txt git add app.txt #将txt文件添加到暂存区 git status On branch main No commits yet Changes to be committed: #现在就显示了即将提交的更改 (use "git rm --cached <file>..." to unstage) new file: app.txt

标题从 Untracked 变成 Changes to be committed,new file: 是 git 给这个文件打的标: 下一次提交会把它作为新文件收进去。

这里提示的是 git rm --cached,因为仓库里还没有任何提交。等有了提交,同一位置提示的是 git restore --staged。

commit提交。-m 后面是提交信息。

git commit -m "add app.txt with version=1" [main (root-commit) 15f7ae2] add app.txt with version=1 1 file changed, 1 insertion(+) create mode 100644 app.txt

注意,这里的 -m 说明提交目的或内容是必要的,也可以在对应的 IDE 里写。

看输出里:分支名 main、root-commit(第一个提交,没有父提交)、短哈希 15f7ae2。 下面一行是这次动了几个文件、增删几行。


git status On branch main nothing to commit, working tree clean git log --oneline 15f7ae2 add app.txt with version=1

working tree clean 表示三个位置内容一致。git log --oneline 一次提交一行, 前 7 位是哈希。

core.autocrlf true 管行尾:提交时把 CRLF 存成 LF,检出时再转回来。 开了之后 git add 会多打一行 warning: LF will be replaced by CRLF the next time Git touches it,不是错误。

核心循环

一次内容的提交顺序:

固定提交顺序: 修改文件后: 工作区 暂存区(Index) 本地仓库(.git) 远程仓库 version=2 version=1 version=1 version=1 正在编辑的新内容 旧内容 旧内容 旧内容 │ │ git add <文件> ▼ 执行 git add 后: 工作区 暂存区(Index) 本地仓库(.git) 远程仓库 version=2 version=2 version=1 version=1 已修改的文件 下次提交的完整清单 旧内容 旧内容 │ │ git commit -m "提交说明" ▼ 执行 git commit 后: 工作区 暂存区(Index) 本地仓库(.git) 远程仓库 version=2 version=2 version=2 version=1 与暂存区一致 与本地仓库一致 新提交已生成 仍是旧版本 │ │ git push ▼ 执行 git push 后: 工作区 暂存区(Index) 本地仓库(.git) 远程仓库 version=2 version=2 version=2 version=2 一致 一致 一致 已同步 团队协作时的循环: ┌──────────────────────┐ │ 远程仓库 │ └──────┬────────▲──────┘ git pull │ │ git push / git fetch │ │ ▼ │ ┌──────────────────────┐ │ 本地仓库(.git) │ └──────┬────────▲──────┘ checkout/merge│ │ git commit ▼ │ ┌──────────────────────┐ │ 工作区 │ └──────┬────────▲──────┘ │ │ git add│ │编辑文件 ▼ │ ┌──────────────────────┐ │ 暂存区(Index) │ └──────────────────────┘ 固定提交链: 工作区 --git add--> 暂存区 --git commit--> 本地仓库 --git push--> 远程仓库 同步回来: 远程仓库 --git pull/fetch--> 本地仓库 --checkout/merge--> 工作区 一句话记忆: 修改在工作区,git add 进暂存区, git commit 存本地仓库,git push 到远程仓库; 协作时先 pull 同步,再改、add、commit、push,循环往复。

git init之后的首要文件

项目文件夹在git初始化之后应该先创建两个文件:.gitignore 和 README.md

README.md 是项目的说明文件,里面可以写项目的简介、安装方法、使用方法等信息,方便其他人了解和使用你的项目。

.gitignore 是 git 的忽略文件,里面可以写一些不需要被 git 跟踪提交的文件或文件夹,比如编译生成的中间文件、日志文件、临时文件、超大文件等,避免这些文件被提交到版本库中。

首要写好gitignore

注意,.gitignore 一定要马上写好,否则你的敏感信息可能会被提交上去。

以下是常见 .gitignore 配置:

# ========== .gitignore 语法速查 ========== # 1) # 开头是注释;空行被忽略 # 2) 模式不带 / 时,匹配任意层级 # 3) 结尾带 / 只匹配目录 # 4) 开头带 / 只匹配仓库根目录 # 5) ! 表示取反(重新包含) # 6) 支持 * ? [] ** 等通配符 # 7) 行尾空格会被忽略,可用 \ 转义 # ========================================= # --- 注释与空行(上面已演示,空行如下)--- # --- 通配符 --- *.log # 任意 .log 文件 *.tmp *~ # 编辑器备份 ?.bak # 单字符 + .bak [abc].txt # a.txt / b.txt / c.txt [0-9]*.dat # 数字开头的 .dat **/node_modules/ # 任意层级的 node_modules docs/**/*.pdf # docs 下任意深度的 pdf # --- 目录匹配 --- build/ # 只匹配名为 build 的目录 dist/ .cache/ # --- 根目录锚定 --- /config.json # 只忽略仓库根的 config.json !/config.json # 若上面被父规则忽略,这里重新包含 /secret/ # 只忽略根目录下的 secret/ # --- 取反 --- *.env !.env.example # 保留示例文件 # --- 转义 --- \#notes.txt # 文件名真的以 # 开头 \!important.txt # 文件名真的以 ! 开头 # --- 常见实用项(精简)--- .DS_Store Thumbs.db .idea/ .vscode/ node_modules/ __pycache__/ *.py[cod] .venv/ target/ *.class .env *.log

文件状态:Git 眼里的文件

git 只看一件事:这个文件之前是否已经被 add,一旦 add 过一次,这个文件就会被永远被跟踪,并且无法被 .gitignore 忽略; 想要删除跟踪要手动输入git rm -r --cached 目录名或者直接用git rm -r 目录名来删除跟踪并删除文件。

跟踪了之后,git会自动比较内容跟上次提交比变没变。

git status -s 的输出

状态

什么意思

?? app.txt

未跟踪

从没 add 过,git 不管它

什么都不输出

已跟踪·未修改

内容跟上次提交一样

 M app.txt

已跟踪·已修改

改过,没进暂存区

M  app.txt

已暂存

改过并已 add,下次提交会带上

MM app.txt

已暂存又改了

add 之后又改了一次

A  app.txt

新文件已暂存

从没提交过,已 add

注意 M 是「暂存区没动,工作区改了」,M  是「暂存区改了,工作区没动」, MM 是两边都改了。两列量的是前面三个位置之间的距离。

不加 -s 时,同样的信息分成三块,标题直接说明白:

Changes to be committed: 已暂存 Changes not staged for commit: 改过,没暂存 Untracked files: 从没被跟踪

一个文件可以同时出现在前两块里,那就是 MM。

git diff

git diff 是一个只读的差异查看器:它挑出同一个文件的两个版本,逐行比对, 把「多了什么、少了什么、改了什么」打印出来。它不修改工作区、不动暂存区、不产生提交,看完即走。

所以它的作用只有一个:回答「这两份内容差在哪」。真正需要先搞清楚的,是「这两份」指的是哪两份。

它到底在比什么

Git 里同一个文件可能同时存在好几份内容:上次提交里的(HEAD)、暂存区里的、磁盘工作区里的。 git diff 的参数就是用来选「拿哪两份来比」。不带参数时,默认比的是暂存区和工作区:

git diff 暂存区 ←→ 工作区

也就是「我改了、但还没 git add 的那部分」。这一点是理解后面所有现象的关键: git diff 从来不是「看所有改动」,它只看它被指定的那一对。

输出怎么读

把 app.txt 从 version=1 改成 version=2,别的都不动,然后跑一次 git diff:

git status -s M app.txt git diff diff --git a/app.txt b/app.txt index 03770cf..badc32f 100644 --- a/app.txt +++ b/app.txt @@ -1 +1 @@ -version=1 +version=2

逐行拆开看:

输出行

含义

diff --git a/app.txt b/app.txt

声明这次比较涉及的两个路径,a/ 是旧、b/ 是新

index 03770cf..badc32f 100644

两份内容在 Git 对象库里的短哈希,100644 是普通文件模式

--- a/app.txt / +++ b/app.txt

旧文件 / 新文件的标识

@@ -1 +1 @@

差异块(hunk)头:旧文件从第 1 行起、新文件从第 1 行起

-version=1

旧版本有、新版本没有(删除或改前)

+version=2

新版本有、旧版本没有(新增或改后)

开头是空格的行是「上下文」,两边都一样,只是用来定位;- 和 + 才是真正的差异。 一行改一半,Git 也会拆成「删一整行 + 加一整行」,因为它是按行比的,不理解行内字符。

git status -s 里的  M 是空格加 M:第一列(暂存区)没动,第二列(工作区)改了。 它和 git diff 说的是同一件事,只是一个是状态摘要、一个是逐行明细。

同一对内容,换个位置看就没了

把改动加进暂存区:

git add app.txt git status -s M app.txt

M 挪到了第一列:暂存区变了,工作区没变。这时候再跑 git diff,什么都没有 —— 它只比工作区和暂存区,而这两边现在一模一样。

改动没丢,它在暂存区里,只是要用比较「上次提交和暂存区」的那条命令才看得到:

git diff --staged diff --git a/app.txt b/app.txt index 03770cf..badc32f 100644 --- a/app.txt +++ b/app.txt @@ -1 +1 @@ -version=1 +version=2

输出和刚才的 git diff 一模一样,因为比的内容都是 version=1 和 version=2, 只是站的观察位置不同:一个从暂存区往工作区看,一个从上次提交往暂存区看。

先分清问的是哪个 diff

git diff 没有输出,只说明工作区等于暂存区,不说明没有改动。 要确认「这次提交会带上什么」,看 git diff --staged。

三种常用写法,各比哪一对

再改一次,app.txt 现在是 version=3:

git status -s MM app.txt

两个 M:暂存区里是 git add 那一刻的版本(version=2),工作区里是刚存的版本(version=3)。 同一个文件,三个位置,三个版本,三个都能单独读出来:

git show HEAD:app.txt version=1 git show :app.txt version=2 cat app.txt version=3

HEAD:文件名 读上次提交里的那一份,:文件名 读暂存区里的那一份,cat 读磁盘。 三条 diff 就是从这三份里各挑一对:

命令

左边

右边

输出里的两行

git diff

暂存区

工作区

-version=2 / +version=3

git diff --staged

上次提交(HEAD)

暂存区

-version=1 / +version=2

git diff HEAD

上次提交(HEAD)

工作区

-version=1 / +version=3

三者可以互相推导:HEAD→工作区 的差异,等于 HEAD→暂存区 加上 暂存区→工作区。 记住「每条 diff 只是选了不同的一对快照」,就不会再被「为什么没输出」绕晕。

提交,看看到底带上了哪个版本

git commit -m "bump version to 2" [main d250bbe] bump version to 2 1 file changed, 1 insertion(+), 1 deletion(-) git show HEAD:app.txt version=2 git status -s M app.txt

提交里是 version=2,磁盘上还是 version=3,git status -s 依旧报一条  M。 version=3 从没进过暂存区,也就不在这次提交里。要把 version=3 也提交,得再 git add 一次—— 改几次就 add 几次,不是 add 一次管到底。

其他常用形式

git diff 不止能比区域,也能比任意两个提交或分支;加路径参数还能把范围缩小到某个文件:

git diff --stat # 只看每个文件改了几行,不打印内容 git diff app.txt # 只比这一个文件 git diff 15f7ae2 d250bbe # 比两次提交 git diff main feature # 比两个分支

一句话收尾:git diff 本身不产生任何副作用,它只是在回答「你让我比的这两份,差在哪」。 用之前先问自己一句:我想比的是哪两份? 答案定了,命令就定了。

提交信息怎么写

提交信息是提交对象的一部分,跟着提交一起存进历史,之后 git log 会原样打印出来。 换句话说,你写下的每个字都是给别人(包括三个月后的自己)看的,而 git diff 只负责说明「改了什么」, 「为什么改」只能由提交信息承担。

git log commit d250bbe32531d8a6ab9400c9c8cf0ed0f834d167 Author: Zhang San <zhangsan@example.com> Date: Sun Nov 15 17:41:28 2026 +0800 bump version to 2 commit 15f7ae2e92364c2c1c77fa32c947ab4e5911874d Author: Zhang San <zhangsan@example.com> Date: Sun Nov 15 17:41:25 2026 +0800 add app.txt with version=1

逐项拆开看:

字段

含义

commit d250bbe…

这次提交的哈希,40 位十六进制;git log --oneline 只显示前 7 位

Author

写这次改动的人,来自配置里的 user.name 和 user.email

Date

提交时间

缩进的那行

提交信息本身,第一行是主题,其余是正文

不加 -m 时发生了什么

如果直接跑 git commit,git 会打开编辑器,里面预填了这样一段:

# Please enter the commit message for your changes. Lines starting # with '#' will be ignored, and an empty message aborts the commit. # # On branch main # Changes to be committed: #	modified: app.txt

以 # 开头的行都是注释,保存退出时会被整段丢掉。真正要你自己写的只有三样: 第一行主题、一个空行、正文。

主题行和正文各写什么

第一行说这次做了什么。用动词开头(add、fix、rename、remove), 控制在 50 字符以内。这个长度的目的是:git log --oneline 一行就能读完,别人扫一眼历史就知道每次改了什么。

正文说为什么改。改了什么去看 git diff 就行了,为什么改只有写的人知道。 空一行再写正文,是为了让工具能把第一行单独当标题处理。

命令行里可以用两个 -m 一次写全,git 会在两段之间自动插一个空行:

git commit -m "bump version to 3" -m "the fixture file now matches production"

只写一个 -m 就是只有标题、没有正文。多数小改动这样足够;需要解释「为什么」时,再补第二个 -m。

这段文字存在哪:回到 .git 目录

提交信息不是飘在空中的,它和其他所有东西一样,都落在 .git 里。看一眼里面的结构:

ls .git COMMIT_EDITMSG HEAD config description hooks index info logs objects refs

先记住三个最关键的:

名字

装什么

objects/

所有内容(文件内容、目录树、提交对象)都压成对象存在这里,文件名就是内容哈希

refs/

名字到哈希的映射,比如 refs/heads/main 里写着一个提交哈希

HEAD

记录「当前在哪个分支」,内容是一行引用

顺着这三个文件读一遍,就能把「分支」「当前提交」串起来:

cat .git/HEAD ref: refs/heads/main cat .git/refs/heads/main d250bbe32531d8a6ab9400c9c8cf0ed0f834d167

HEAD 指向一个分支名,分支文件里是 40 位哈希。分支本质上就是一个写着提交哈希的文件, 没有更神秘的东西。第 3 课讲分支时,就是从这里出发。

剩下几个也顺手认一下:

  • config:安装配置时不带 --global 写进去的那份仓库级配置。

  • index:暂存区本身。git add 改的就是它,git ls-files -s 能把它逐行打出来。

  • COMMIT_EDITMSG:上一次写提交信息时编辑器里的草稿,方便重用。

objects 里到底装了什么

objects 里一个文件就是一份内容,文件名是这份内容的哈希,按前两位分目录存放。 跑 ls .git/objects 会看到 03、0f、15、ba、cf、d2 这些目录,外加 info、pack。

git count-objects -v count: 6

count: 6 对应的是两次提交、两棵树、两个版本的 app.txt,各一份对象。 这就是 Git 省空间的方式:内容相同就复用同一个对象,不重复存。

提交对象能整个读出来

git cat-file -p HEAD tree 0ff94ebbd8442510fc2bdacd885a747bf4f67c99 parent 15f7ae2e92364c2c1c77fa32c947ab4e5911874d author Zhang San <zhangsan@example.com> 1794735688 +0800 committer Zhang San <zhangsan@example.com> 1794735688 +0800 bump version to 2

一个提交对象就这几行:

行

含义

tree

这一版的目录内容,指向一棵树对象

parent

上一次提交,用来串成历史链

author / committer

作者和提交者身份,带时间戳和时区

最后的空行 + 文字

提交信息本身

注意:提交对象里没有 - 也没有 +。差异从来不被存下来, 而是 git diff 拿两棵树临时算出来的。这也是为什么「改了什么」永远可以重算,「为什么改」只能靠提交信息保留。

树对象里是「权限、类型、哈希、文件名」四元组,指向真正的内容:

git cat-file -p HEAD:app.txt version=2

git diff 头上那行 index 03770cf..badc32f,就是改动前后两个版本的哈希, 和 objects 里的目录名对得上——前面看到的 03 和 ba 两个目录,正是它们。

这一课收束

走完了三个位置(工作区、暂存区、本地仓库)和两个动词:git add 把改动抄进暂存区, git commit 把暂存区封存成一个提交对象、写进 objects、再更新 refs/heads/main。 其余命令,都是在这几个位置上做比较和搬运。