Refactor git.md for improved clarity and organization; remove unnecessary mermaid diagram and enhance flowchart labels

This commit is contained in:
2026-04-20 11:43:01 +08:00
parent 12bac2ad40
commit 9994c47b66

View File

@@ -4,39 +4,7 @@
数字工作离不开版本管理(Version Control),你可以把 Git 想象成「时间机器」,它不仅负责记录、回溯时间点。还能允许你分裂、跳跃、合并时间线。
在 Git 中,提交(Commit)就是时间点;分支(Branch)就是时间线。Git 有很多实践流派,偶魔采用的是 [GitHub Flow](https://docs.github.com/zh/get-started/using-github/github-flow) 简化版:
```mermaid
---
config:
theme: neutral
gitGraph:
mainBranchName: "主分支"
showCommitLabel: false
---
gitGraph
commit
commit
branch "个人分支-1"
checkout "主分支"
commit
branch "个人分支-2"
checkout "个人分支-1"
commit
checkout "个人分支-2"
commit
checkout "个人分支-1"
commit
checkout "个人分支-2"
commit
checkout "主分支"
merge "个人分支-1"
checkout "主分支"
merge "个人分支-2"
commit
```
为了方便初学者理解,我用直白的语言表述:
在 Git 中,提交记录(Commit)就是时间点;分支(Branch)就是时间线。Git 有很多实践流派,偶魔采用的是 [GitHub Flow](https://docs.github.com/zh/get-started/using-github/github-flow) 简化版,基于人分支,永不删除。为了方便初学者理解,我用直白的语言表述:
1. 仅在自己的「个人分支」工作,互不干扰
2. 通过「提交」,有选择地确认改动到个人分支
@@ -50,11 +18,9 @@ flowchart TD
main(主分支 main)
changes -- 提交(自审) --> dev
dev -- 合并请求(终审) --> main
main -- 更新 --> dev
```
通过双审核机制,本地改动最终更新到主分支上。这样,即解放了本地创作限制,又规范了线上协作流程。有效避免了同步网盘方案中,高频改动导致的文件冲突问题,以及 AI 操作导致的潜在安全风险。
本地改动,通过双审核机制,才更新到主分支上。这样,即解放了本地创作限制,又规范了线上协作流程。有效避免了同步网盘方案中,高频改动导致的文件冲突问题,以及 AI 操作导致的潜在安全风险。
接下来,我将说明具体的操作(确保已安装 Git、VS Code,详见 [必装软件/工具](starter.md))
@@ -165,9 +131,9 @@ PR 会加入队列,等待审核通过。通过后就会合并到主分支啦
```mermaid
flowchart TD
changes(本地改动)
staged(暂存改动)
dev(本地个人分支)
changes(本地改动 Changes)
staged(暂存改动 Staged Changes)
dev(本地个人分支 dev)
changes -- git add --> staged
staged -- git commit --> dev
@@ -176,22 +142,22 @@ flowchart TD
这部分是最普通不过的 Git 单人使用方式:通过「Add - Commit - 创作」的循环往复,项目不断发展,留下一条线性的提交历史,记录了每次改动的内容。
你可以不和团队发生任何联系,也能让 Git 发挥功能,帮你储存项目关键时间节点,用于查看、回溯等操作。我们不是为了协作而使用 Git,我们是为了让创作过程「有迹可循」,培养大家的好习惯。就像那些能记录绘画过程的软件,除了创作结果,不觉得创作记录本身也很酷么?
你可以不和团队发生任何联系,也能让 Git 发挥功能,帮你储存关键时间节点,用于查看、回溯等操作。我们不是为了协作而使用 Git,我们是为了让创作过程「有迹可循」,培养大家的好习惯。就像那些能记录绘画过程的软件一样,除了创作结果外,不觉得创作记录本身也很酷么?
### 团队协作管理循环
```mermaid
flowchart TD
dev-1(本地个人分支)
origin-dev(远程个人分支)
origin-main(远程主分支)
dev-1(本地个人分支 dev)
origin-dev(远程个人分支 origin/dev)
origin-main(远程主分支 origin/main)
dev-1 -- git push --> origin-dev
origin-dev -- PR --> origin-main
origin-main -- git pull origin main --> dev-1
```
这部分才是团队协作的体现,个人分支通过 PR 传给主分支,同时更新来自主分支的改动,构成了「个人」和「团队」的协同。PR 也确保了个人内容被单向的、有监督地并入,保障了安全性、稳定性。
这部分才是团队协作的体现,个人分支通过 PR 传给主分支,同时更新来自主分支的改动,构成了「个人」和「团队」的协同。PR 确保了个人内容被单向的、有监督地并入,保障了安全性、稳定性。
只要记住这个 ♾️ 双循环,你就完全理解了这套工作流程。