告别混乱笔记！用这套工具链，打造你的第二大脑
你是否经历过这些场景？
- 想找之前记录的知识，翻遍所有笔记却找不到
- 收藏了无数文章，却再也没有打开过
- 笔记软件换了一个又一个，数据迁移痛苦不堪
- 想建立知识体系，却不知从何下手
这些问题困扰了我很久，直到我遇到了 Obsidian + Git + Claude 这套工具链。
本文将带你从零搭建一套终身可用的个人知识库，实现：
- ✅ 所有笔记版本可控，永不丢失
- ✅ AI辅助整理，效率翻倍
- ✅ 跨设备同步，随时随地访问
- ✅ 知识图谱可视化，发现隐藏关联
一、工具介绍与安装
本系列文章用到的核心工具：
| 工具 | 作用 | 是否必须 |
|---|---|---|
| Obsidian | 知识库核心软件 | 必须 |
| Git | 版本控制，数据安全 | 必须 |
| VSCode | 辅助编辑器 | 可选 |
| Claude | AI辅助整理 | 进阶使用 |
| CC Switch | AI工具管理 | 进阶使用 |
1.1 Obsidian 安装
Obsidian 是一款基于本地 Markdown 文件的笔记软件，核心特点：
- 本地优先：数据完全掌握在自己手中
- 双向链接：
[[笔记名]]语法建立知识关联 - 知识图谱：可视化展示笔记之间的关系
- 插件生态：丰富的社区插件扩展功能
Mac 系统安装
方式一：官网下载
访问 obsidian.md，点击下载 macOS 版本。
方式二：Homebrew 安装（推荐）
如果你已经安装了 Homebrew，可以直接运行：
brew install --cask obsidian
安装完成后，在启动台或 Spotlight 搜索中找到 Obsidian 并打开。
Windows 系统安装
方式一：官网下载
访问 obsidian.md，点击下载 Windows 版本（.exe 安装包）。
方式二：Scoop 安装
如果你使用 Scoop 包管理器：
scoop bucket add extras
scoop install obsidian
安装完成后双击桌面图标启动。
1.2 Git 安装与配置
Git 是版本控制工具，配合 Obsidian 使用可以实现：
- 自动备份笔记历史
- 误删内容可恢复
- 多设备同步
- 协作编辑
Mac 系统安装
检查是否已安装
打开终端，运行：
git --version
如果显示版本号，说明已安装。如果提示找不到命令，则需要安装。
安装 Git
# 使用 Homebrew 安装
brew install git
初始配置
安装完成后，配置你的身份信息：
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
Windows 系统安装
下载安装
访问 git-scm.com/download/wi… 下载安装包。
安装选项说明
安装过程中，建议保持默认选项。几个关键选项：
- 编辑器选择：建议选择 VSCode 或 Notepad++
- PATH 配置：选择 "Git from the command line"
- 换行符转换：选择 "Checkout Windows-style, commit Unix-style"
安装完成后，打开 Git Bash（不是 CMD），进行初始配置：
git config --global user.name "你的名字"
git config --global user.email "你的邮箱"
1.3 VSCode 安装（可选）
VSCode 是强大的代码编辑器，可以作为 Obsidian 的辅助工具：
- 批量编辑笔记
- 正则表达式搜索替换
- 多光标编辑
- Git 可视化操作
Mac 系统安装
brew install --cask visual-studio-code
Windows 系统安装
访问 code.visualstudio.com 下载安装。
二、创建第一个知识库
2.1 选择存储位置
知识库（在 Obsidian 中称为"仓库"或"Vault"）本质上就是一个文件夹，里面存放所有 Markdown 文件。
建议的存储位置：
- Mac:
~/Documents/my-knowledge-base或~/Dropbox/my-knowledge-base - Windows:
D:\my-knowledge-base或云盘同步目录
💡 小贴士：如果你使用云盘同步（如 Dropbox、iCloud、OneDrive），可以把知识库放在同步目录中，实现自动跨设备同步。
2.2 新建仓库
- 打开 Obsidian
- 点击「创建新仓库」
- 输入仓库名称，如
my-knowledge-base - 选择存储位置
- 点击「创建」
创建完成后，你会看到 Obsidian 的主界面：
- 左侧：文件列表
- 中间：编辑区域
- 右侧：预览区域（点击右上角预览按钮显示）
2.3 基础设置配置
点击左下角齿轮图标进入设置。
外观设置
- 主题：选择你喜欢的主题（推荐 Default 或 Minimal）
- 字体大小：根据个人喜好调整
- 界面语言：中文
编辑器设置
- 自动配对括号：开启
- 智能缩进：开启
- 拼写检查：根据需要开启
- 显示行号：开启
文件设置
- 默认新建笔记位置：根目录或指定文件夹
- 附件默认位置：建议创建
attachments文件夹
2.4 创建第一篇笔记
按 Cmd/Ctrl + N 新建笔记，输入以下内容：
# 欢迎
这是我的第一篇 Obsidian 笔记！
## 我为什么选择 Obsidian
- 数据本地存储，完全掌控
- Markdown 格式，通用性强
- 双向链接，建立知识网络
- 插件丰富，可定制性强
## 相关笔记
[[读书笔记/如何阅读一本书]] ← 这是链接示例
三、核心概念入门
3.1 双向链接 [[]]
Obsidian 最核心的功能是双向链接，语法是 [[笔记名]]。
创建链接
今天学习了 [[Python基础]]，感觉收获很大。
当笔记「Python基础」不存在时，链接会显示灰色；点击会自动创建该笔记。
查看反向链接
当你在「Python基础」笔记中时，右侧面板会显示所有链接到这篇笔记的其他笔记，这就是"双向"的含义。
链接到标题
[[Python基础#变量与数据类型]] ← 链接到特定标题
链接到段落
[[Python基础#^block-id]] ← 链接到特定段落（需要先定义块ID）
3.2 标签系统
标签是另一种组织笔记的方式，语法是 #标签名。
这篇文章主要讨论 #编程/Python 和 #学习笔记 相关内容。
标签 vs 链接
| 特性 | 标签 | 链接 |
|---|---|---|
| 用途 | 分类、过滤 | 建立关联 |
| 层级 | 支持 #父/子 | 不支持 |
| 可见性 | 标签面板 | 图谱视图 |
| 反向 | 无 | 有反向链接 |
3.3 文件夹组织建议
Obsidian 支持文件夹，但不建议过度依赖文件夹分类。
推荐的结构：
my-knowledge-base/
├── 00-索引与模板/ # MOC主页、模板文件
│ ├── MOC-主页.md
│ └── 模板-日记.md
├── 01-日记/ # 每日笔记
├── 02-读书笔记/ # 读书笔记
├── 03-技术文档/ # 技术学习
├── 04-项目管理/ # 项目相关
├── 05-归档/ # 不活跃的笔记
├── attachments/ # 图片等附件
└── .gitignore # Git忽略配置
核心原则：
- 文件夹用于粗粒度分类，链接用于细粒度关联
- 一篇笔记可以属于多个"类别"（通过链接和标签）
- 使用 MOC（Map of Content）作为导航入口
四、Git 版本控制配置
4.1 初始化 Git 仓库
打开终端（Mac）或 Git Bash（Windows），进入知识库目录：
cd ~/Documents/my-knowledge-base # Mac
cd D:\my-knowledge-base # Windows
# 初始化 Git 仓库
git init
4.2 配置 .gitignore
创建 .gitignore 文件，排除不需要版本控制的文件：
# Obsidian 工作区配置（包含窗口位置等，不需要同步）
.obsidian/workspace.json
.obsidian/workspace-mobile.json
# 回收站
.trash/
# 系统文件
.DS_Store
Thumbs.db
# 临时文件
*.tmp
*.temp
4.3 首次提交
# 添加所有文件到暂存区
git add .
# 创建首次提交
git commit -m "初始化知识库"
4.4 设置远程仓库（可选但推荐）
如果你想在 GitHub/GitLab 上备份，或实现多设备同步：
# 在 GitHub 创建仓库后，添加远程地址
git remote add origin https://github.com/你的用户名/my-knowledge-base.git
# 推送到远程
git push -u origin main
五、总结与预告
恭喜你！到这里，你已经：
- ✅ 安装了 Obsidian 和 Git
- ✅ 创建了第一个知识库
- ✅ 掌握了双向链接和标签
- ✅ 配置了版本控制
但这只是开始。在下一篇文章中，我们将：
- 安装 5 个核心插件，让知识库"活"起来
- 配置自动备份和模板系统
- 搭建日记 + 任务 + 笔记的联动工作流
- 介绍 CC Switch 工具管理 AI 工具
下一篇：Obsidian进阶：这5个插件让你的知识库"活"起来
附录：常见问题
Q: Obsidian 收费吗？
A: 个人使用完全免费。付费的 Sync 和 Publish 服务是可选的，我们用 Git 可以免费实现类似功能。
Q: 数据安全吗？
A: 数据完全存储在本地，你可以用 Git 备份到任何地方，完全掌控。
Q: 能在手机上用吗？
A: Obsidian 有 iOS 和 Android 客户端。配合 Git 或云盘同步，可以在手机上查看和编辑笔记。
Q: 和 Notion、印象笔记有什么区别？
A: 核心区别是"本地优先"vs"云端优先"。Obsidian 数据在你自己手里，迁移成本极低。
📌 系列文章
- 本文：入门篇 - 从零搭建Obsidian知识库
- 下一篇：进阶篇 - 插件生态与工作流优化
