程序员的第二大脑：Obsidian + GitHub 搭建本地知识库实战

发表于 标签：

前言

随着工作年限的增长，我发现自己积累了大量技术知识和项目经验：

  • RF Calibration开发经验
  • Linux Performance优化学习
  • C++开发技巧
  • AI与Transformer学习笔记
  • 英语学习写作、面试与会议表达
  • 项目问题分析与解决方案

这些内容散落在电脑文件夹、聊天记录、邮件和文档中，查找和复用都十分困难。

为了建立长期可复用的知识体系，我决定搭建一个属于自己的「第二大脑（Second Brain）」。

最终选择：

  • Obsidian：本地知识管理工具
  • Git：版本管理
  • GitHub：远程备份与同步

本文记录完整搭建过程。

为什么选择 Obsidian

在选择知识管理工具之前，我对比了几种主流方案：

工具 优势 劣势
Notion 云端同步方便 数据不完全本地
OneNote Office生态完善 知识关联能力弱
Evernote 功能成熟 扩展性有限
Obsidian 本地存储、双链、插件丰富 需要自行规划

最终选择 Obsidian 的原因：

  1. 所有数据均为 Markdown 文件
  2. 数据完全属于自己
  3. 支持知识关联与图谱
  4. 支持 Git 管理
  5. 插件生态丰富
  6. 对程序员非常友好

环境准备

操作系统

1
macOS Intel

软件准备

安装以下软件：

  • Obsidian
  • Git
  • GitHub账号

验证 Git 是否安装成功：

1
git --version

输出类似：

1
git version 2.51.0

创建 Obsidian Vault

创建知识库目录

1
mkdir ~/KnowledgeBase

打开 Obsidian

选择：

1
Create New Vault

命名：

1
KnowledgeBase

选择目录：

1
~/KnowledgeBase

创建完成后即可开始记录笔记。

规划目录结构

根据个人职业发展方向设计目录：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
KnowledgeBase
│
├── 01_Work
│   ├── Qualcomm
│   ├── RF_Calibration
│   └── Linux_Performance
│
├── 02_AI
│   ├── Transformer
│   ├── LLM
│   └── Agent
│
├── 03_Programming
│   ├── C++
│   ├── Linux
│   └── RTOS
│
├── 04_Quant
│
├── 05_English
│
├── 06_DailyNotes
│
└── Attachments

这样可以将工作、学习和成长记录统一管理。

初始化 Git 仓库

进入知识库目录：

1
cd ~/KnowledgeBase

初始化：

1
git init

查看状态：

1
git status

首次提交：

1
2
git add .
git commit -m "Initial Commit"

创建 GitHub 仓库

在 GitHub 创建仓库：

1
KnowledgeBase

注意：

不要勾选：

  • README
  • LICENSE
  • .gitignore

避免后续推送产生冲突。

配置 SSH 登录

GitHub 已经不再支持账号密码推送。

推荐使用 SSH。

生成密钥：

1
ssh-keygen -t ed25519 -C "your_email@example.com"

查看公钥：

1
cat ~/.ssh/id_ed25519.pub

复制输出内容。

进入 GitHub：

1
2
3
Settings
→ SSH and GPG Keys
→ New SSH Key

粘贴公钥并保存。

测试连接：

1
ssh -T git@github.com

成功输出：

1
Hi username! You've successfully authenticated.

关联远程仓库

添加远程地址：

1
git remote add origin git@github.com:username/KnowledgeBase.git

检查配置：

1
git remote -v

输出：

1
origin git@github.com:username/KnowledgeBase.git

推送代码到 GitHub

第一次推送：

1
2
3
git branch -M main

git push -u origin main

如果出现：

1
fatal: The current branch main has no upstream branch

执行：

1
git push --set-upstream origin main

即可解决。

推荐安装的插件

Calendar

用于每日笔记管理。

效果：

1
2
3
2026-06-24.md
2026-06-25.md
2026-06-26.md

每天自动生成工作与学习记录。

Dataview

动态查询知识库内容。

例如：

1
2
3
4
5
TABLE
file.mtime as 更新时间
FROM "02_AI"
SORT file.mtime DESC
LIMIT 10

自动统计最近更新内容。

Excalidraw

绘制：

  • 架构图
  • 流程图
  • RTOS状态机
  • Transformer结构图

是技术人员必备插件之一。

Obsidian Git

自动执行：

1
2
3
git add .
git commit
git push

实现知识库自动备份。

Obsidian 的核心价值

普通文件夹：

1
2
3
Transformer.docx
Attention.docx
LLM.docx

彼此独立。

Obsidian：

1
2
3
4
5
[[Transformer]]

[[Attention]]

[[LLM]]

形成知识网络：

1
2
3
4
5
LLM
 │
Transformer
 │
Attention

随着笔记增加，会逐渐形成自己的知识图谱。

我的知识库规划

未来计划持续沉淀以下内容：

工作

  • RF Calibration
  • Modem性能优化
  • Linux Performance

AI

  • Transformer
  • LLM
  • Agent

编程

  • C++
  • Linux
  • RTOS

英语

  • 面试表达
  • 技术会议表达
  • 常用商务邮件

量化交易

  • 策略研究
  • 回测记录
  • 实盘复盘

总结

知识的价值不在于收藏，而在于不断沉淀与复用。

Obsidian + GitHub 的组合：

  • 数据本地存储
  • Markdown格式开放
  • Git版本管理
  • GitHub远程备份
  • 双向链接构建知识网络

对于程序员来说，这是一套成本极低、可长期使用的个人知识管理方案。

希望几年后回头再看，这个知识库已经成为自己最重要的技术资产之一。