早上打开 Obsidian,插件全没了。主题变成默认白色。快捷键一个都不认。
那个感觉像是走进了自己家,但家具全被搬空了。
系列上一篇讲了怎么快速捕获信息。这篇换个方向——聊聊知识库本身的「配置」怎么备份和恢复。
配置比笔记更容易丢
知识库的笔记有 Syncthing、有 Git、有各种备份手段。但 .obsidian/ 目录下的东西——几十个插件、调好的快捷键、自定义 CSS、主题配色——这些经常被忽略。
丢了笔记可以重写,丢了配置要重新调。
一台新电脑上,同步完笔记只需要几分钟。但要回到原来的 Obsidian 工作环境——插件版本、快捷键、外观——可能需要一两周。
Obsidian 的配置都在一个文件夹里
所有配置都在 vault 目录下的 .obsidian/ 文件夹里。
your-vault/
└── .obsidian/
├── plugins/ ← 插件本体
├── snippets/ ← CSS 片段
├── themes/ ← 主题
├── hotkeys.json ← 快捷键
├── community-plugins.json ← 插件列表
├── app.json ← 核心设置
├── appearance.json ← 外观设置
└── workspace.json ← 工作区布局
几个关键文件:
community-plugins.json 只记录启用的插件列表。两 KB 的 JSON,没有插件本体。
plugins/ 目录存放插件本体。每个插件一个文件夹,加起来可能在几十 MB。
hotkeys.json 很小但很值钱。调了一周的快捷键都在这里。
snippets/ 存 CSS 片段。几个 KB,但视觉调优的心血全在里面。
app.json 和 appearance.json 是编辑器设置。很小,但错了看着就不对。
三种备份方案
方案一:Git 顺手管上
如果知识库已经用 Git 做版本管理,在 .gitignore 里加这几行就行。
!.obsidian/community-plugins.json !.obsidian/hotkeys.json !.obsidian/snippets/ !.obsidian/app.json !.obsidian/appearance.json
只跟踪配置信息,不跟踪插件本体。优点是不需要额外操作。提交笔记的时候顺手保存配置。
注意不要跟踪整个 plugins/ 目录——插件本体太大,而且版本控制没有意义。
方案二:脚本打包
不需要每次都备份。想起来了或者要大调整前跑一次。
# backup-obsidian-config.sh BACKUP_DIR="./config-backups/$(date +%Y%m%d)" mkdir -p "$BACKUP_DIR" cp ".obsidian/community-plugins.json" "$BACKUP_DIR/" cp ".obsidian/hotkeys.json" "$BACKUP_DIR/" cp ".obsidian/app.json" "$BACKUP_DIR/" cp ".obsidian/appearance.json" "$BACKUP_DIR/" cp -r ".obsidian/snippets/" "$BACKUP_DIR/" ls ".obsidian/plugins/" > "$BACKUP_DIR/plugin-list.txt"
跑完得到一个带日期的目录。每次备份几十 KB,纯文本,可以用 Git 管理。
方案三:全量同步 .obsidian/
条件允许的话,最省心的是把整个 .obsidian/ 目录纳入同步。
包括 plugins/ 目录。用 Syncthing 同步整个 vault 时,在配置里把 .obsidian/ 的过滤去掉就行。Syncthing 只传增量,插件本体的变化频率很低。
新电脑上装好 Obsidian、指向 vault 目录、等同步完成。打开就是原来的样子。
恢复流程
不管用哪种方案,恢复步骤都差不多。
第一步,装 Obsidian。 去官网下载安装包。
第二步,同步 vault。 把整个 vault 目录同步到新电脑。
第三步,打开 Obsidian。 选择 vault 目录。Obsidian 自动识别 .obsidian/ 配置,加载插件和主题。
第四步,关掉安全模式。 设置 → 第三方插件。如果插件显示「未安装」,等同步完成再检查。
第五步,重启 Obsidian。 确保所有插件正常初始化。
前后不到十分钟。
几个实用技巧
插件列表单独备份。 把 community-plugins.json 放到 Git 私有仓库。哪天插件版本兼容出问题,翻出旧文件对比就能找到原因。
区分配置和缓存。 .obsidian/ 下面有些目录是运行时生成的缓存。拿不准的时候,只备份上面列的那几个 JSON 文件和 snippets/ 目录就够了。
跨平台注意。 Mac 和 Windows 的 Obsidian 在某些功能上有差异。如果经常切换,建议在 app.json 里关掉 native 相关设置。
前几篇讲了知识库的内容管理、日常操作、还有这篇的配置备份。系列还剩一个比较有意思的话题:知识库搭好了,怎么把管理权交接出去——我们的知识库「多人协作」方案。下一篇来说说。