工作区 (Working Directory)

你正在编辑的文件所在的目录

随意创作的地方，修改未保存前仅存在于本地文件系统。

暂存区 (Staging Area)

临时存放准备提交的文件区域

Git 提供的“反悔”和“整理”机会；可只提交部分修改；通过 git add 进入。

本地仓库 (Local Repository)

提交后保存在电脑里的版本历史

单机版历史记录；断网也可查看历史、回滚；通过 git commit 进入。

远程仓库 (Remote Repository)

GitHub/GitLab 等云端仓库

云端存档和团队共享中心；通过 git push/pull 进行同步。

配置与初始化

git config --global user.name/email

配置用户身份

安装后必须执行一次。

git init

本地新建仓库

在当前目录初始化。

git clone <url>

从云端克隆仓库

自动关联远程仓库 origin。

状态与查看

git status

查看文件状态

红色=未暂存，绿色=已暂存，无内容=干净。

git log --oneline

查看提交历史

推荐加 --oneline 简洁显示；加 --graph 看分支图。

git remote -v

查看远程仓库地址

确认关联的远程仓库 URL。

提交操作

git add <file> / .

添加到暂存区

. 表示添加所有修改；不会追踪删除的文件。

git commit -m "msg"

提交到本地仓库

消息需清晰描述修改内容（如 fix: ...）。

撤销与回退

git checkout -- <file>

撤销工作区修改

危险：永久丢弃未 add 的修改。

git reset HEAD <file>

撤销暂存

从暂存区移除，但保留工作区修改。

git reset --hard <ver>

回退到历史版本

核武器：本地重置；若已 push，严禁对主分支强制推送。

git rm <file>

删除文件

需配合 commit 使用。

远程同步

git pull

拉取云端最新代码

等价于 fetch + merge；工作前务必执行。

git push origin <branch>

推送到云端

将本地分支推送到远程指定分支。

main / master

生产环境

神圣不可侵犯；只有经过测试、稳定的代码才能合并；对应线上正式版本。

dev (develop)

开发环境

日常开发主线；所有功能分支最终合并至此进行集成测试。

test

测试环境

用于测试人员验证代码稳定性（部分企业流程使用）。

feature/

个人/功能开发

独立沙盒；如 feature/user-login；日常开发的主战场，不影响主版本。

hotfix/

紧急修复

线上出现 Bug 时，从 main 拉出分支修复，修完后合并回 main 和 dev。

1. 同步代码

拉取最新代码

git pull

确保本地基于最新代码开发，减少冲突。

2. 创建分支

创建并切换分支

git checkout -b feature

基于 main/dev 创建独立功能分支。

3. 开发编码

编写/修改代码

(编辑文件)

在独立分支中进行开发。

4. 暂存修改

添加到暂存区

git add .

标记准备提交的文件。

5. 提交版本

提交到本地仓库

git commit -m "说明"

撰写清晰的提交信息。

6. 推送分支

推送到远程

git push origin feature

关键差异：团队协作中，直接推送功能分支到远程，而非合并到主分支。

7. 代码审查

发起合并请求

(Web端操作)

在 GitHub/GitLab 发起 Pull Request (PR)，邀请同事 Review。

8. 合并发布

合并到主分支

(Web端自动合并)

审查通过后，由系统自动合并到 main/dev，确保代码质量与安全。