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 # 如果是Windowssudo 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=1working 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会自动比较内容跟上次提交比变没变。
| 状态 | 什么意思 |
|---|---|---|
| 未跟踪 | 从没 add 过,git 不管它 |
什么都不输出 | 已跟踪·未修改 | 内容跟上次提交一样 |
| 已跟踪·已修改 | 改过,没进暂存区 |
| 已暂存 | 改过并已 add,下次提交会带上 |
| 已暂存又改了 | add 之后又改了一次 |
| 新文件已暂存 | 从没提交过,已 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逐行拆开看:
输出行 | 含义 |
|---|---|
| 声明这次比较涉及的两个路径, |
| 两份内容在 Git 对象库里的短哈希, |
| 旧文件 / 新文件的标识 |
| 差异块(hunk)头:旧文件从第 1 行起、新文件从第 1 行起 |
| 旧版本有、新版本没有(删除或改前) |
| 新版本有、旧版本没有(新增或改后) |
开头是空格的行是「上下文」,两边都一样,只是用来定位;- 和 + 才是真正的差异。 一行改一半,Git 也会拆成「删一整行 + 加一整行」,因为它是按行比的,不理解行内字符。
git status -s 里的 M 是空格加 M:第一列(暂存区)没动,第二列(工作区)改了。 它和 git diff 说的是同一件事,只是一个是状态摘要、一个是逐行明细。
同一对内容,换个位置看就没了
把改动加进暂存区:
git add app.txt git status -s M app.txtM 挪到了第一列:暂存区变了,工作区没变。这时候再跑 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=3HEAD:文件名 读上次提交里的那一份,:文件名 读暂存区里的那一份,cat 读磁盘。 三条 diff 就是从这三份里各挑一对:
命令 | 左边 | 右边 | 输出里的两行 |
|---|---|---|---|
| 暂存区 | 工作区 |
|
| 上次提交( | 暂存区 |
|
| 上次提交( | 工作区 |
|
三者可以互相推导: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逐项拆开看:
字段 | 含义 |
|---|---|
| 这次提交的哈希,40 位十六进制; |
| 写这次改动的人,来自配置里的 |
| 提交时间 |
缩进的那行 | 提交信息本身,第一行是主题,其余是正文 |
不加 -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先记住三个最关键的:
名字 | 装什么 |
|---|---|
| 所有内容(文件内容、目录树、提交对象)都压成对象存在这里,文件名就是内容哈希 |
| 名字到哈希的映射,比如 |
| 记录「当前在哪个分支」,内容是一行引用 |
顺着这三个文件读一遍,就能把「分支」「当前提交」串起来:
cat .git/HEAD ref: refs/heads/main cat .git/refs/heads/main d250bbe32531d8a6ab9400c9c8cf0ed0f834d167HEAD 指向一个分支名,分支文件里是 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: 6count: 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一个提交对象就这几行:
行 | 含义 |
|---|---|
| 这一版的目录内容,指向一棵树对象 |
| 上一次提交,用来串成历史链 |
| 作者和提交者身份,带时间戳和时区 |
最后的空行 + 文字 | 提交信息本身 |
注意:提交对象里没有 - 也没有 +。差异从来不被存下来, 而是 git diff 拿两棵树临时算出来的。这也是为什么「改了什么」永远可以重算,「为什么改」只能靠提交信息保留。
树对象里是「权限、类型、哈希、文件名」四元组,指向真正的内容:
git cat-file -p HEAD:app.txt version=2git diff 头上那行 index 03770cf..badc32f,就是改动前后两个版本的哈希, 和 objects 里的目录名对得上——前面看到的 03 和 ba 两个目录,正是它们。
这一课收束
走完了三个位置(工作区、暂存区、本地仓库)和两个动词:git add 把改动抄进暂存区, git commit 把暂存区封存成一个提交对象、写进 objects、再更新 refs/heads/main。 其余命令,都是在这几个位置上做比较和搬运。