Git 四大区与 Shelve 搁置：从入门到 IDEA 实战

Tue, 15 Sep 2015 00:00:00 +0800

Git 四大区

Git 内部有 4 个工作区域：

区域	英文	说明
工作区	Working Directory	本地写代码的目录
暂存区	Staging Area / Index	`git add` 后的"准备提交"区
本地仓库	Local Repository	`git commit` 后的本地历史
远程仓库	Remote Repository	`git push` 后的云端历史

1
2
3
4


工作区（写代码）
 → git add → 暂存区（准备提交） git stash 隐藏更改
 → git commit → 本地仓库（本地保存）
 → git push → 远程仓库（云端保存）

git stash 是隐藏工作区的更改到栈里（不提交到任何区），方便你拉最新代码或者切换任务。

git stash：紧急任务切换

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


# 当前正在改功能 A，写了一半
# 突然来了 bugB 要修

# 1. 把功能 A 暂存起来
git stash

# 2. 拉最新代码
git pull origin master

# 3. 切到 bug 分支修
git checkout -b fix-bugB
# ... 改完、commit、push、merge ...

# 4. 切回功能 A 分支
git checkout feature-A

# 5. 恢复暂存
git stash pop

# 6. 继续功能 A 开发

stash 是栈结构，支持多个：

1
2
3
4
5


git stash # 暂存当前
git stash list # 查看所有 stash
git stash apply stash@{0} # 应用指定 stash
git stash drop stash@{0} # 删除指定 stash
git stash pop # 应用并删除最近一个

git restore：撤销本地的编辑

1
2
3
4
5
6
7
8


# 撤销工作区的修改（未 add）
git restore 文件1 文件2

# 撤销暂存（已 add，但未 commit）
git restore --staged 文件1 文件2

# 撤销工作区 + 暂存
git restore --staged --worktree 文件1

IDEA 中的回滚：

VCS → Git → Restore File：相当于 git restore
Local History → Show History：IDEA 自动保存的本地历史
VCS → Git → Reset HEAD：回滚所有未提交修改

IDEA 的 reset 默认不删除"已提交"的文件副本，所以回滚不删除文件——已跟踪的文件从绿变红。

git HEAD：指针机制

HEAD 是当前分支最新提交的"指针"。

HEAD^：上一个提交（HEAD~1）
HEAD^^：上上一个（HEAD~2）
HEAD@{2}：reflog 中第 3 个 HEAD 位置（用于找回 reset 掉的 commit）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 查看 reflog
git reflog

# 把 HEAD 切到上一个提交
git checkout HEAD^

# 恢复误删的分支
git reflog
# 找到 commit SHA
git checkout -b recovered-branch <SHA>

git restore vs git checkout vs git reset 三者区别

命令	作用
`git restore <file>`	撤销工作区/暂存区的修改（Git 2.23+ 新命令）
`git checkout -- <file>`	同上（旧语法）
`git reset --soft HEAD^`	撤销 commit，保留暂存
`git reset --mixed HEAD^`	撤销 commit + 暂存，保留工作区
`git reset --hard HEAD^`	撤销 commit + 暂存 + 工作区（危险，慎用）

IDEA 的 Shelve 搁置

什么是 Shelve

IDEA 的 Shelve（搁置） 是 JetBrains IDE 独有的功能，定位：

【任务切换神器】 不是为了拉代码，是为了 把写一半的功能收起来，去干别的事。

它像一个临时的、私有的、微型补丁分支——不污染 git 历史，跨分支切换时不被带走。

使用场景

1
2
3
4
5
6
7
8


正在写【功能 A】，写了一半
突然来了【紧急 bugB】要修！
不想提交 A，也不想删 A

→ 把 A 搁置（Shelve）起来
→ 工作区变干净
→ 去修 bugB
→ 修完把 A 恢复回来继续

操作步骤

Git → Uncommitted Changes → Shelve Changes…
命名（建议"功能A-2026-06-04"）
工作区立刻变干净
切到 bugB 分支修
修完提交
Git → Uncommitted Changes → Unshelve… 选之前搁置的名字
恢复继续功能 A

与 git stash 的区别：Shelve 是 IDE 本地的，跨电脑不共享；stash 是 git 仓库级别的，commit 后可推送。

git-crypt：透明加密

团队项目经常需要提交敏感配置（.env、数据库密码），但又怕直接 push 到公网。git-crypt 是 Git 的透明加密插件：

文件本地是明文
git push 后云端是密文
团队成员对称加密：每个有 GPG key 的人都能解密

1
2
3
4
5
6
7
8


# Linux 下载
wget https://github.com/AGWA/git-crypt/releases/download/0.7.0/git-crypt-0.7.0-linux-x86_64

# Windows 下载
wget https://github.com/AGWA/git-crypt/releases/download/0.7.0/git-crypt-0.7.0-x86_64.exe

# 放到 PATH
mv git-crypt-0.7.0-x86_64 /usr/local/bin/git-crypt

配置 .gitattributes

1
2
3
4
5


# .gitattributes
.env filter=git-crypt diff=git-crypt
config/prod.yaml filter=git-crypt diff=git-crypt
*.key filter=git-crypt diff=git-crypt
*.pem filter=git-crypt diff=git-crypt

初始化

1
2
3


git-crypt init
git add .gitattributes
git commit -m "Add git-crypt config"

添加 GPG 协作者

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 协作者生成 GPG key
gpg --gen-key
# 上传公钥到 keyserver
gpg --keyserver keys.openpgp.org --send-keys <KEY_ID>

# 信任他
git-crypt add-gpg-user <GPG_USER_ID>

# 协作者 clone 后 unlock
git-crypt unlock

常用命令速查

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24


# 远程分支
git branch -r

# 检出远程分支
git checkout release_V3.1.4

# 关联分支
git branch --set-upstream-to=origin/master master

# 查看单个文件的历史
git log -p -- path/to/file

# 暂存部分文件
git add -p
# y/n/q/a/d 等交互式命令

# 撤销合并
git revert -m 1 <merge_commit_sha>

# 修改最后一次 commit
git commit --amend

# 改作者邮箱（全局）
git filter-branch --env-filter 'GIT_AUTHOR_EMAIL=xxx'

下一步

想用 GitHub Actions 自动化 CI，看 2017-12-08《K8s Ingress 实战》
想用 monorepo 工具（pnpm + turbo）管理多项目，看 2020-04-15《FSS 全栈脚手架》

参考资料

Pro Git 简体中文：https://git-scm.com/book/zh/v2
git-crypt：https://github.com/AGWA/git-crypt
IDEA Shelve 文档：https://www.jetbrains.com/help/idea/shelving-and-unshelving-changes.html

Git-Crypt on Liangweidong's blog