三区模型：工作区、暂存区与仓库

  工作区              暂存区              仓库
 (Working Dir)      (Staging/Index)     (Repository)
      |                   |                  |
      |  ---- git add --->|                  |
      |                   |--- git commit -->|
      |<--------- git checkout / restore ----|
      |                   |                  |
  你能看见和              .git/index        .git/objects
  编辑的文件            （一份文件清单）    （所有历史快照）

   未跟踪            已跟踪
 (untracked)
     |
     |  git add
     v
  +-------------+   编辑文件   +-------------+   git add   +-------------+
  |  已暂存      | ----------> |   已修改     | ----------> |   已暂存     |
  | (staged)    |             | (modified)  |             | (staged)    |
  +-------------+             +-------------+             +-------------+
     |                                                          |
     | git commit                                               | git commit
     v                                                          v
  +-------------+                                          +-------------+
  |  未修改      |  <---------------------------------------|  未修改     |
  | (unmodified)|                                          | (unmodified)|
  +-------------+                                          +-------------+

git init -q
echo 'v1' > a.txt
git add .
git commit -q -m "init: a.txt"
 
echo '===== 起点：干净的工作区 ====='
git status --short --branch
echo '(除了分支行没有别的输出 = 三区完全一致)'
echo
 
echo '===== 1. 修改文件 -> 改动只在工作区 ====='
echo 'v2' > a.txt
echo 'new' > b.txt
git status --short
echo '   M = 已修改未暂存    ?? = 未跟踪'
echo
 
echo '===== 2. git add -> 改动进入暂存区 ====='
git add a.txt b.txt
git status --short
echo '  M  = 已暂存的修改    A  = 新增已暂存'
echo
 
echo '===== 3. 再改一次 a.txt -> 同一文件同时处于两种状态 ====='
echo 'v3' > a.txt
git status --short
echo '  MM = 暂存区里是 v2，工作区里还有更新的 v3'
echo
 
echo '===== 4. commit -> 落入仓库 ====='
git add a.txt
git commit -q -m "feat: 更新 a，新增 b"
git status --short
echo '(没有输出，又干净了)'

 工作区  <--(1) git diff -->  暂存区  <--(2) git diff --staged -->  HEAD
   |                                                                 |
   +---------------- (3) git diff HEAD ------------------------------+

git init -q
echo 'line1' > code.txt
echo 'line2' >> code.txt
echo 'line3' >> code.txt
git add .
git commit -q -m "init"
 
# 改一版并暂存
echo 'line1' > code.txt
echo 'line2-changed' >> code.txt
echo 'line3' >> code.txt
echo 'line4' >> code.txt
git add code.txt
 
# 再改一版，这次不暂存
echo 'line5-not-staged' >> code.txt
 
echo '===== git diff：工作区 vs 暂存区（还没 add 的改动）====='
git diff
echo
 
echo '===== git diff --staged：暂存区 vs 最新提交（这次 commit 会包含什么）====='
git diff --staged
echo
 
echo '===== git diff HEAD：工作区 vs 最新提交（全部改动）====='
git diff HEAD
echo
 
echo '===== git diff HEAD --stat：只看统计 ====='
git diff HEAD --stat

diff --git a/code.txt b/code.txt     <- a = 旧版本, b = 新版本
index 83db48f..a00cdb9 100644        <- 两个 blob 的哈希 + 文件权限
--- a/code.txt                       <- 旧版本标记
+++ b/code.txt                       <- 新版本标记
@@ -1,3 +1,4 @@                      <- 变更块：旧版从第1行起3行, 新版从第1行起4行
 line1                               <- 空格开头 = 上下文，未变
-line2                               <- 减号 = 旧版有、新版删掉
+line2-changed                       <- 加号 = 新增
 line3
+line4

git init -q
echo 'base' > README.md
git add .
git commit -q -m "init"
 
echo '# 一次编辑干了两件事：修 bug + 写文档'
echo 'fixed bug' > bugfix.py
echo 'base + docs' > README.md
git status --short
echo
 
echo '===== 拆成两个提交：先只暂存 bugfix.py ====='
git add bugfix.py
git status --short
echo '(README.md 的改动留在工作区，不会进这次提交)'
git commit -q -m "fix: 修复登录空指针"
echo
 
echo '===== 再暂存文档 ====='
git add README.md
git commit -q -m "docs: 补充说明"
echo
 
echo '===== 结果：两个语义清晰、可独立回退的提交 ====='
git log --oneline
echo
 
echo '===== 索引里存的其实是「模式 + 内容哈希 + 路径」====='
git ls-files --stage

git add -p file.py     # 逐个 hunk 询问 y/n/s/e

# add
git add file.txt          # 单个文件
git add src/              # 整个目录
git add .                 # 当前目录及子目录的所有改动（含新增、删除）
git add -A                # 整个仓库的所有改动（不受当前目录限制）
git add -u                # 只暂存"已跟踪文件"的修改与删除，不加新文件
git add -p                # 交互式部分暂存
 
# commit
git commit -m "msg"       # 带信息提交
git commit                # 打开编辑器写多行信息
git commit -a -m "msg"    # 跳过 add：自动暂存所有【已跟踪】文件的改动
git commit --amend        # 修补上一个提交（改信息或补文件）
git commit -q -m "msg"    # 安静模式，少打印