Refactor .gitignore for improved clarity and organization; remove unused git-pr-list image
This commit is contained in:
BIN
notes/assets/git-pr-list.png
LFS
BIN
notes/assets/git-pr-list.png
LFS
Binary file not shown.
38
notes/git.md
38
notes/git.md
@@ -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
|
||||
|
||||

|
||||
|
||||
> 或执行 `git add [file]`
|
||||
或执行 `git add [file]`
|
||||
|
||||
**2. 提交(Commit)改动**
|
||||
|
||||
@@ -105,7 +107,7 @@ flowchart TD
|
||||
|
||||

|
||||
|
||||
> 或执行 `git commit -m [message]`
|
||||
或执行 `git commit -m [message]`
|
||||
|
||||
**3. 推送(Push)到远程仓库的个人分支**
|
||||
|
||||
@@ -115,10 +117,11 @@ flowchart TD
|
||||
|
||||

|
||||
|
||||
> 或执行 `git push`
|
||||
或执行 `git push`
|
||||
|
||||
这步是工作中最常用的:一边工作,一边适时地 Add > Commit > Push
|
||||
|
||||
|
||||
### 更新其他人在「主分支」的改动
|
||||
|
||||
当你在自己分支工作时,其他人也在不断改动主分支`main`。有时需要对齐一下,拉取(Pull)并合并(Merge)来自主分支的更新到你自己的分支。
|
||||
@@ -127,14 +130,17 @@ flowchart TD
|
||||
|
||||

|
||||
|
||||
> 或执行 `git pull origin main`
|
||||
或执行 `git pull origin main`
|
||||
|
||||
如果冲突,会进入`([branch-name]|MERGING)` 状态,详见 [解决冲突](#解决合并冲突)
|
||||
|
||||
|
||||
### 通过「合并请求」来确认改动到主分支
|
||||
|
||||
合并请求(Pull Request,PR)就是个人分支合并入主分支的申请。
|
||||
|
||||
> ⚠️ 在提 PR 前,**一定**要在本地执行 [同步「主分支」的改动](#同步「主分支」的改动)(且同步给了远程仓库的个人分支)
|
||||
|
||||
浏览器访问仓库主页,切换到个人分支,点击 New Pull Request 按钮(3)
|
||||
|
||||

|
||||
@@ -145,14 +151,11 @@ flowchart TD
|
||||
|
||||
PR 会加入队列,等待审核通过。通过后就会合并到主分支啦。
|
||||
|
||||

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