Refactor .gitignore for improved clarity and organization; remove unused git-pr-list image

This commit is contained in:
2026-04-19 18:18:01 +08:00
parent 6a540e4657
commit 1cae80ca80
4 changed files with 398 additions and 29 deletions

Binary file not shown.

View File

@@ -25,6 +25,10 @@ gitGraph
commit
checkout "个人分支-2"
commit
checkout "个人分支-1"
commit
checkout "个人分支-2"
commit
checkout "主分支"
merge "个人分支-1"
checkout "主分支"
@@ -40,10 +44,6 @@ gitGraph
4. 通过「合并请求」,有监督地确认改动到主分支
```mermaid
---
config:
theme: neutral
---
flowchart TD
changes(本地改动)
dev(个人分支 dev)
@@ -58,6 +58,7 @@ flowchart TD
接下来,我将说明具体的操作(确保已安装 Git、VS Code,详见 [必装软件/工具](starter.md))
### 仅在自己的「个人分支」工作
**1. 下载仓库(Repository)**
@@ -87,6 +88,7 @@ flowchart TD
分支列表中有一些 `origin/*` 开头的分支,它们是属于远程仓库中的分支。但注意,这不代表它们存在于远程!想象一下,如果你处于断网状态,那么实际上这些 `origin/*` 分支也没有获得更新。而且它们的状态不会自动更新,除非你执行 `git fetch`、`git pull`、`git push`。
### 通过「提交」来确认改动到个人分支
**1. 有选择性地添加(Add)改动**
@@ -95,7 +97,7 @@ flowchart TD
![](assets/git-add.png)
> 或执行 `git add [file]`
或执行 `git add [file]`
**2. 提交(Commit)改动**
@@ -105,7 +107,7 @@ flowchart TD
![](assets/git-commit.png)
> 或执行 `git commit -m [message]`
或执行 `git commit -m [message]`
**3. 推送(Push)到远程仓库的个人分支**
@@ -115,10 +117,11 @@ flowchart TD
![](assets/git-push.png)
> 或执行 `git push`
或执行 `git push`
这步是工作中最常用的:一边工作,一边适时地 Add > Commit > Push
### 更新其他人在「主分支」的改动
当你在自己分支工作时,其他人也在不断改动主分支`main`。有时需要对齐一下,拉取(Pull)并合并(Merge)来自主分支的更新到你自己的分支。
@@ -127,14 +130,17 @@ flowchart TD
![](assets/git-pull-origin-main.png)
> 或执行 `git pull origin main`
或执行 `git pull origin main`
如果冲突,会进入`([branch-name]|MERGING)` 状态,详见 [解决冲突](#解决合并冲突)
### 通过「合并请求」来确认改动到主分支
合并请求(Pull Request,PR)就是个人分支合并入主分支的申请。
> ⚠️ 在提 PR 前,**一定**要在本地执行 [同步「主分支」的改动](#同步「主分支」的改动)(且同步给了远程仓库的个人分支)
浏览器访问仓库主页,切换到个人分支,点击 New Pull Request 按钮(3)
![](assets/git-checkout-feat.png)
@@ -145,14 +151,11 @@ flowchart TD
PR 会加入队列,等待审核通过。通过后就会合并到主分支啦。
![](assets/git-pr-list.png)
⚠️ 在提 PR 前,**一定**要在本地执行[同步「主分支」的改动](#同步「主分支」的改动)(且同步给了远程仓库的个人分支)
> 在提 PR 后,如果你又更新了你的分支,不必再次提 PR
## 最佳实践
### 多设备编辑同一分支
首先不推荐这样做,但是为了一个设备,新加分支也很没必要。但如果由一个人操作这些设备,比如个人的 macbook、iphone 共同编辑,只要严格遵守下面两条:
@@ -161,19 +164,20 @@ PR 会加入队列,等待审核通过。通过后就会合并到主分支啦
> 为什么不用 icloud?因为这样可以实现部分同步,能适应复杂的文件夹,打开也更快。
### 解决合并冲突
解决完冲突后,继续
> 或执行 `git merge --continue`
或执行 `git merge --continue`
或者退出,不解决
> 或执行 `git merge --abort`
或执行 `git merge --abort`
> 大文件处理完合并后,变成指针文件
> 执行 `git lfs pull` 拉回原始文件
大文件处理完合并后,变成指针文件
执行 `git lfs pull` 拉回原始文件
### 虽然文件 ignore 了,但因为曾经加过,所以还在被追踪
@@ -184,4 +188,4 @@ PR 会加入队列,等待审核通过。通过后就会合并到主分支啦
### 个人分支的提交记录,本地和远程仓库不一致
`git push --force-with-lease`
执行 `git push --force-with-lease`

View File

@@ -2,14 +2,22 @@
偶魔的采用 Omoospace 方案管理项目文件夹。在它基础上设置了如下结构:
```bash
[root-dir]
├── .obsidian # obsidian 配置文件
├── contents/ # 被引用的资源、成品
├── notes/ # 记录文档
├── references/ # 资料文件
├── subspaces/ # 工程文件、制作文件
├── OMOOSPACE.md # Omoospace
└── README.md # 自述文档
```
存放和项目相关的,项目专属的文件,例如
- 项目专属的配置文件
- 创作过程文件
私密的、涉及安全的,绝不能放入,例如
- 密钥、环境配置
- 合同、报价单