~/VibeHandbook
免费 PDF

01 · 02

仓库、提交,以及历史

三个你会不断听到的词。我们把它们讲清楚。

仓库,简称 "repo")就是一个 在盯着的文件夹。你只需把一个普通文件夹变成 repo 一次,从那以后 Git 就会追踪里面的一切。

提交(commit)是一个存档点。它是某一时刻所有文件的快照,外加你写的一句简短说明,描述改了什么("加上登录页面""修好坏掉的注册按钮")。你会不断地做提交——把每一个都想成一个你可能想回去的检查点。

历史是所有提交按顺序排成的列表。它就是时间线。你可以滚动浏览,读每次改动是什么,并穿越回任意一个时间点。

实际操作起来是这样的。不用背——大多数时候你会让 AI 替你运行——但跟着读一遍,让这些词不再神秘:

# 把当前文件夹变成一个 Git 仓库(只需做一次)
git init

# 查看自上一个存档点以来哪些文件变了
git status

# 暂存你的改动,然后带一句说明保存为一次提交
git add .
git commit -m "Add the homepage layout"

# 查看你的历史——每一次提交,最新的在前
git log --oneline

git add . 是你在说"把我所有的改动都纳入下一个存档点"。git commit 才是真正的保存。-m "..." 是写给未来自己的便条。写一些一个月后你自己还能看懂的便条。

这两条命令把你的工作推过三个阶段。你编辑的文件,只有一路走到最右边,才算真正保存:

   ┌─────────────────┐  git add   ┌─────────────────┐  git commit  ┌─────────────────┐
   │   WORKING DIR   │ ─────────▶ │     STAGING     │ ───────────▶ │     HISTORY     │
   │ 正在编辑的文件  │            │   选中的改动    │              │  已保存的提交   │
   │   (尚未保存)    │            │  (供下次保存)   │              │   (永久安全)    │
   └─────────────────┘            └─────────────────┘              └─────────────────┘
           你修改                       你选择                     它成为一张         
          一个文件                  放入提交的内容                  永久快照          

想离线阅读?

免费下载整本书的 PDF 或 EPUB。