知识库「配置备份与恢复」方案:换电脑后十分钟恢复完整工作环境

早上打开 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              ← 工作区布局

Obsidian 配置目录结构

几个关键文件:

community-plugins.json 只记录启用的插件列表。两 KB 的 JSON,没有插件本体。

plugins/ 目录存放插件本体。每个插件一个文件夹,加起来可能在几十 MB。

hotkeys.json 很小但很值钱。调了一周的快捷键都在这里。

snippets/ 存 CSS 片段。几个 KB,但视觉调优的心血全在里面。

app.jsonappearance.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 相关设置。

前几篇讲了知识库的内容管理、日常操作、还有这篇的配置备份。系列还剩一个比较有意思的话题:知识库搭好了,怎么把管理权交接出去——我们的知识库「多人协作」方案。下一篇来说说。

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部