Git 本地仓库包含工作区、暂存区、版本库这三个核心区域,掌握这三个区域流转逻辑,就能学会文件添加提交、版本回退等基础 git 命令,很多新手操作失误,本质就是分不清文件到底在哪个区域。工作区就是你电脑上能直接看到、编辑的项目文件夹,你新增或者修改代码文件,改动只停留在工作区;执行 git add,会把改动放到暂存区做临时存放;再执行 git commit,才会把暂存区内容打包存入本地版本库生成版本快照。如果提交之后发现代码写错,可以通过 git reset 命令做版本回退,回退支持三种模式,分别对应不同区域的重置策略。理解三区流转顺序之后,add、commit、reset 的作用就很清晰,修改文件先到工作区,add 进暂存区,commit 固化版本,回退操作可以反向撤销已经提交或者暂存的改动,在本地调试代码版本,不会直接影响远程仓库。
一、Git 本地三个区域基础说明
| 区域 | 别名 | 作用 | 可见性 |
|---|---|---|---|
| 工作区 | Working Directory | 存放项目原始文件,直接编辑修改 | 电脑文件夹可直接查看 |
| 暂存区 | Index / Stage | 临时存放待提交改动,作为提交前的缓冲区 | 不能直接浏览,git status 查看状态 |
| 本地版本库 | Repository | 保存所有历史版本快照,包含分支、提交记录 | .git 文件夹内部,不建议手动修改 |
二、文件添加基础命令清单
- 查看文件状态
git status
查看当前工作区、暂存区文件改动情况,红色代表工作区未 add,绿色代表已经进入暂存区。
2. 将文件从工作区添加到暂存区
git add 文件名 添加单个文件
git add . 添加当前目录全部改动
- 将暂存区内容提交到本地版本库,生成版本记录
git commit -m "填写本次提交备注"
三、版本回退 git reset 三种模式
- --soft:只移动版本库 HEAD 指针,保留暂存区和工作区,改动还在暂存区。适合修改上一次提交备注。
git reset --soft HEAD~1
- --mixed(默认模式):移动 HEAD,清空暂存区,改动放回工作区。不加参数默认就是 mixed,最常用。
git reset HEAD~1
- --hard:移动 HEAD,清空暂存区,直接丢弃工作区所有改动,改动会丢失,谨慎使用。
git reset --hard HEAD~1
HEAD~1 代表回退到上一个提交版本;HEAD~2 回退两个版本。
四、完整操作流程示例
- 修改项目文件,改动存在
- git add . 把改动送入
- git commit -m "feat: 新增功能" 存入
- 发现代码错误,执行 git reset 做版本回退,按需选择 soft/mixed/hard 模式
【工作区】
【暂存区】
【本地版本库】
五、操作风险提示
- git reset --hard 会丢弃本地未提交修改,执行前最好备份代码。
- 本地回退只是修改本地版本库,如果已经 push 推送到远程仓库,不能直接用 reset 覆盖远程分支,会造成远程仓库冲突。
- 只在本地未推送的提交上使用 reset,已推送到远端的提交,优先使用 git revert 生成新提交来撤销改动。
【常见问题】
问题 1:Git 命令基础涉及本地三个区,git add 命令作用在 Git 本地三个区之间做什么操作?
回答 1:Git 命令基础涉及本地三个区,git add 命令会将工作区里的文件改动,上传转移到暂存区,暂存区作为临时缓冲区,等待后续 git commit 提交进本地版本库。
问题 2:Git 命令基础涉及本地三个区,git reset --hard 回退版本有什么风险?
回答 2:Git 命令基础涉及本地三个区,git reset --hard 会同时重置版本库、清空暂存区,并且直接删除工作区内未提交的代码改动,代码改动会丢失,使用前务必做好备份。
问题 3:Git 命令基础涉及本地三个区,工作区、暂存区、版本库三者流转顺序是什么?
回答 3:Git 命令基础涉及本地三个区,默认流转顺序:修改文件产生改动在工作区 → git add 将改动送入暂存区 → git commit 把暂存区内容保存到本地版本库生成版本快照。
【参考资料】
[2026-11-16](Git 基础:工作区、暂存区、版本库三区概念,add 与 reset 回退)廖雪峰 Git 教程
[2026-11-16](git reset 三种模式详解,版本回退操作指南)掘金
[2026-11-15](Git 本地三区原理与基础命令实操)InfoQ
[2026-11-12](git add、git commit 基础命令使用说明)菜鸟教程
【免责声明】
本文内容仅为 Git 命令基础技术资讯解读,不构成正式项目开发规范。Git 本地三个区、添加与回退操作存在数据丢失风险,在正式项目仓库操作前建议备份代码;涉及远程分支回退场景需要结合团队 Git 规范执行。
