Git 使用手册 · 初级篇：从第一次提交开始

Sat, 22 Aug 2026 23:21:00 +0800

这是 Git 手册系列的第一篇。目标只有一个：让你今天就能用 Git 管好自己的代码，并且知道每条命令在干什么。不理解原理没关系，先把工作流跑通。

Git 是什么，解决什么问题
安装与初始配置
四个区域：工作区、暂存区、本地仓库、远程仓库
第一次提交
日常三板斧：status / add / commit
查看历史
撤销与回退（安全版）
连接远程仓库（GitHub / GitLab）
分支是什么（先会用最基础的）
初级常见错误

Git 是什么，解决什么问题

没有 Git 的时候，你是这样管理代码的：

project/
project-final/
project-final-v2/
project-final-v2-真的最终版/

Git 做的事：把项目的每一次修改记录成"快照"（commit），你可以随时查看任何历史版本、回到任何历史版本、同时维护多条并行的修改线（分支），并和别人协作而互不覆盖。

安装与初始配置

# macOS
brew install git

# Ubuntu / Debian
sudo apt install git

# Windows：安装 Git for Windows（自带 Git Bash）

第一次使用必须先配置身份，否则提交会带上机器默认的匿名信息：

git config --global user.name "你的名字"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main

验证：

git config --list

四个区域：工作区、暂存区、本地仓库、远程仓库

这是理解 Git 所有命令的钥匙：

工作区          暂存区          本地仓库          远程仓库
(working dir)   (staging)      (repository)     (remote)
    |               |               |                |
    |  git add  →   |  git commit → |  git push  →   |
    |               |               |                |
    |  ← checkout   |  ← reset      |  ← git pull    |

工作区：你正在编辑的文件
暂存区：下一次提交要包含的内容（一个"待打包区"）
本地仓库：已经提交的历史快照
远程仓库：GitHub / GitLab / 自建服务器上的副本

为什么要多一个暂存区？因为你可以改 10 个文件，但只把其中 3 个相关的改动打成一次干净的提交。

第一次提交

# 在项目目录初始化仓库
cd my-project
git init

# 查看状态（最重要的命令，有事没事敲一下）
git status

# 把文件放进暂存区
git add README.md        # 单个文件
git add .                # 所有变更（初级可以先这样用）

# 提交到本地仓库
git commit -m "初始化项目：添加 README"

提交信息（commit message）的约定：一句话说清"做了什么"，用动词开头。例如 修复登录页按钮错位、新增用户注册接口。不要写 update、fix、123。

.gitignore：告诉 Git 别管某些文件

# 依赖与构建产物
node_modules/
dist/
*.log

# 环境与密钥（永远不要提交）
.env
*.pem

# 系统文件
.DS_Store

新建仓库第一件事就是写 .gitignore。如果已经把 node_modules 提交了，用 git rm -r --cached node_modules 把它移出版本库再提交。

日常三板斧：status / add / commit

你的日常循环就是：

git status                    # 现在有哪些改动？哪些已暂存？
git add                 # 挑选改动放入暂存区
git commit -m "做了什么"      # 打包成一次快照

辅助命令：

git diff                      # 工作区 vs 暂存区：还没 add 的改动细节
git diff --staged             # 暂存区 vs 上次提交：这次将要提交什么

提交频率建议：完成一个"说得清的小目标"就提交一次。一天 3~10 次提交很正常；一周一次提交等于没用 Git。

查看历史

git log                       # 完整历史
git log --oneline             # 一行一条，最常用
git log --oneline --graph     # 带分支图形
git show           # 看某次提交的具体改动
git blame               # 文件每一行是谁在哪次提交写的

每次提交有一个 40 位的哈希 id，平时用前 7 位即可指代（如 a1b2c3d）。

撤销与回退（安全版）

初级只需要记住三句，按"还没提交到哪一步"选：

# 1. 改了文件但还没 add：丢弃工作区修改
git restore 

# 2. 已经 add 但还没 commit：退回暂存区（改动保留在工作区）
git restore --staged 

# 3. 已经 commit：再提交一次"反向提交"来撤销，不改历史，最安全
git revert

⚠️ git reset --hard 和 git push --force 会永久丢数据或改写共享历史，初级阶段先别碰，等中级篇再学。

连接远程仓库（GitHub / GitLab）

情形 A：本地已有项目，推到新建的远程仓库

在 GitHub 上创建一个空仓库（不要勾选初始化 README），然后：

git remote add origin git@github.com:yourname/my-project.git
git branch -M main
git push -u origin main

情形 B：从远程克隆一个已有项目

git clone git@github.com:someone/some-project.git
cd some-project

日常同步

git pull        # 拉取远程最新提交并合并到本地
git push        # 推送本地提交到远程

认证推荐配置 SSH key（ssh-keygen 生成后把公钥贴到 GitHub 设置里），一次配置永久免密。

分支是什么（先会用最基础的）

分支 = 一条独立的修改线，互不影响。默认分支是 main。

git branch                      # 列出本地分支
git switch -c feature-login     # 新建并切换到新分支
git switch main                 # 切回 main

典型用法：

git switch -c fix-button        # 开分支做修复
# …改代码、add、commit…
git switch main                 # 回主线
git merge fix-button            # 把修复合并进来
git branch -d fix-button        # 删掉用完的分支
git push                        # 同步到远程

初级记住一个原则：永远别直接在 main 上干活，做任何改动都先开分支。合并冲突暂时不用怕，中级篇会专门讲。

初级常见错误

1. 提交信息写 “update” 一个月后你自己都不知道这次提交干了什么。写具体点。

2. 把 .env、密钥提交了 先 git rm --cached .env 移除并写进 .gitignore。注意：历史里还有，密钥必须立即更换。

3. 在错误的目录 git init 比如在家目录 ~ 下执行了 init。删掉误建的 .git 目录即可：rm -rf ~/.git（确认路径后再执行）。

4. pull 下来一堆冲突，慌了 冲突不是错误，是 Git 在问你"两边都改了，听谁的"。先 git status 看哪些文件冲突，打开文件找 <<<<<<< 标记，手动改对后 add + commit。

5. 半年不 push 本地仓库丢了硬盘就没了。每天至少 push 一次。

本篇速查表

目的	命令
初始化	`git init`
看状态	`git status`
暂存	`git add`
提交	`git commit -m "..."`
看历史	`git log --oneline`
撤销未暂存修改	`git restore`
撤销已暂存	`git restore --staged`
安全撤销某次提交	`git revert`
克隆	`git clone`
拉取 / 推送	`git pull` / `git push`
开分支	`git switch -c`
合并	`git merge`

掌握这些，你已经覆盖了个人项目 90% 的场景。下一篇《中级篇》讲分支协作模型、合并冲突的正确解法、stash、reset 的三种模式和 rebase 入门——也就是从"会用"到"用得对"。

入门教程 on heyaohua's Blog