# Git & GitHub 老兵上手手册

> 用"作战日志 + 档案室"类比，快速上手版本管理
> 适用场景：公众号文章 · 个人定位分析 · 资产分析 · 微信小程序 · 个人网站
> 品牌：LeiFlow · 老雷慢慢说

老兵，git/github 不用先背命令，先把"直觉"建立起来最要紧。我把它类比成你最熟的**作战日志 + 档案室**，三张图给你讲透，再落到你手头的五件事上。

---

## 一、核心直觉（先记一句口诀）

> **口诀**
> **仓库是柜子，提交是盖章的日志页，分支是备用方案，push/pull 是云端同步。**
> GitHub 不过是把柜子放到云上、按权限共享——你自己看叫"私有仓库"，公开给别人看叫"公开仓库"。

---

## 二、Git 核心概念类比

左边是 git 术语，右边是你能秒懂的老兵类比。

| Git 术语 | 老兵类比 | 说明 |
|---|---|---|
| 仓库 Repository | 一个项目的"档案柜" | 所有文件 + 每一次改动，全收在一个柜子里 |
| 提交 Commit | 日志上"盖的章" | 自动记下：谁、何时、改了啥、为啥改 |
| 版本 Version | 日志的"某一页" | 随时翻回任意时间点，精确对比差异 |
| 分支 Branch | "另起一份备用方案" | 新写法/新功能随便试，主线不误工 |
| 推送/拉取 Push/Pull | "云端同步" | 把档案上传到 GitHub / 或从云端取回 |
| 克隆 Clone | "整柜复制" | 换电脑或交接，一键搬走，历史全在 |
| GitHub | 云端的"共享指挥部" | 仓库放上去，按权限自己看（私有）或邀人一起改（协作） |

---

## 三、三种方式能力对比

一眼可见：**本地文件夹几乎全是短板**（靠手动命名 v1/v2/final 版，迟早乱）；**Obsidian 写文章/笔记是强项**，但版本管理和协作弱；**Git+GitHub 在版本、同步、代码、协作上全面强**，唯一代价是"上手门槛"要投入点时间，隐私靠"私有仓库"兜住。

> 图例：强 = 适合 / 中 = 一般 / 弱 = 短板（"上手门槛"那行反过来：低 = 容易）

| 维度 | 本地文件夹 | Obsidian | Git + GitHub |
|---|---|---|---|
| 版本管理 | 弱 | 弱 | 强 |
| 多设备同步 | 弱 | 中 | 强 |
| 历史回溯 | 弱 | 弱 | 强 |
| 写文章/笔记 | 弱 | 强 | 中 |
| 代码开发 | 弱 | 弱 | 强 |
| 多人协作 | 弱 | 弱 | 强 |
| 隐私安全 | 强 | 强 | 中（私有可控） |
| 上手门槛 | 低 | 低 | 需学 |

---

## 四、老雷的最优策略

左边是你正在做的五类事，右边是我建议的工具组合。

| 你的事 | 工具组合 | 关键点 |
|---|---|---|
| 公众号文章 | Obsidian 写 + Git 私有兜底 | 双链整理，每周 7 稿不怕乱 |
| 个人定位分析 | Obsidian + Git 私有 | 卡片搭框架，版本可追溯 |
| 资产分析 | 本地 + Obsidian 私有 | **隐私红线**：绝不公开、不上云 |
| 微信小程序 | Git + GitHub 私有 | 代码刚需，分支开发 |
| 个人网站 | Git + GitHub 公开 | **高光场景**：Pages 免费托管，Markdown 与 Obsidian 无缝 |

> **核心结论**：你不需要在"本地文件夹 / Obsidian / Git"里三选一，它们是分工不是替代——
> **Obsidian** 是"写作主战场"（管怎么写得顺、连得清）；
> **Git** 是"时光机和保险柜"（管改动留痕、随时退回、丢不了）；
> **GitHub** 是"云端指挥部 + 协作入口"（私有当保险柜，公开还能白嫖 Pages 托管）。
>
> 一句话：**Obsidian 写、Git 管版本、GitHub 私有做云端保险柜；代码类跑标准流程，资产只留本地。**

---

## 五、第一次动手 · 操作手册

不用先啃命令，先在 Obsidian 仓库试水。以下 4 步即可把你的知识库变成"带时光机的档案柜"。

**第 1 步：进到你的 Obsidian 库根目录**

```bash
cd ~/你的Obsidian库路径
```

**第 2 步：初始化仓库（相当于立一个档案柜）**

```bash
git init
```

**第 3 步：把当前所有文件收进第一次提交（盖第一枚章）**

```bash
git add .
git commit -m "初版：公众号+定位文档"
```

**第 4 步：在 GitHub 建一个私有仓库，把柜子推上去**

```bash
git remote add origin https://github.com/你的名/你的库.git
git push -u origin main
```

### 日常用法（每次写完一段就做一次）

```bash
git add .
git commit -m "改了啥"
```

等于盖一次章。哪天想回到上周的稿子，用 `git log` 看记录、`git checkout` 翻回去——这就是你的"作战日志时光机"。

> **隐私红线（务必遵守）**
> 资产分析那一块，建议**永远留在本地 + Obsidian 私有 vault，连 GitHub 都别推**。财务隐私这事，宁可少点便利，不能冒半点险。公开仓库只用于个人网站这类"本就该让人看"的内容。

---

*LeiFlow · 老雷慢慢说 ｜ Git & GitHub 老兵上手手册 ｜ 本手册基于"作战日志 + 档案室"类比整理。*