Refactor git.md for improved clarity and organization; remove unnecessary mermaid diagram and enhance flowchart labels
This commit is contained in:
54
notes/git.md
54
notes/git.md
@@ -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 确保了个人内容被单向的、有监督地并入,保障了安全性、稳定性。
|
||||
|
||||
只要记住这个 ♾️ 双循环,你就完全理解了这套工作流程。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user