Obsidian 学习笔记

Appearance

版本迁移指南 ​

Obsidian 定期发布更新，部分版本包含重大变更。本文帮助你顺利完成版本迁移。

版本更新策略 ​

更新通道 ​

通道稳定性获取方式
正式版最稳定自动更新
内测版较稳定设置 → 关于 → 接收内测版
抢先版不稳定手动下载

更新前准备 ​

text
1. 备份仓库（Git commit 或复制文件夹）
2. 记录当前版本号
3. 查看更新日志
4. 检查插件兼容性
5. 在测试仓库中先验证

重大版本变更 ​

Obsidian 1.7.x — Bases 数据库 ​

新功能：

  • 内置 Bases 数据库功能
  • 属性（Properties）增强
  • 新的属性类型支持

迁移注意：

  • 旧版属性格式自动升级
  • obsidian:// URI 新增 Bases 相关操作
  • 部分插件可能需要更新

Obsidian 1.6.x — 属性视图 ​

新功能：

  • 属性视图增强
  • 新的核心插件

迁移注意：

  • Front Matter 格式不变
  • 部分第三方插件需更新

Obsidian 1.5.x — 表格编辑器 ​

新功能：

  • 所见即所得表格编辑
  • 表格工具栏

迁移注意：

  • Markdown 表格格式不变
  • 编辑器行为微调

Obsidian 1.4.x — 属性 ​

重大变更：

  • 属性（Properties）取代 YAML frontmatter 的编辑方式
  • 新的属性面板
  • 属性类型推断

迁移注意：

  • YAML frontmatter 格式不变，仅编辑方式改变
  • 旧的 frontmatter 继续工作
  • 新建笔记默认使用属性面板

Obsidian 1.1.x — Canvas ​

新功能：

  • Canvas 白板功能
  • .canvas 文件格式

迁移注意：

  • 不影响现有 .md 文件
  • 白板文件需要手动创建

Obsidian 1.0.x — 正式版 ​

重大变更：

  • 从 Insider/Beta 进入正式版
  • 稳定性大幅提升
  • API 稳定

插件兼容性 ​

检查插件兼容性 ​

  1. 打开设置 → 第三方插件
  2. 查看是否有更新提示
  3. 查看 GitHub Releases 页面
  4. 检查 manifest.json 中的 minAppVersion

常见兼容性问题 ​

问题原因解决方案
插件加载失败API 变更更新插件
功能异常内部接口变更等待开发者更新
样式错乱CSS 变量名变更更新 CSS 片段
命令丢失命令注册方式变更更新插件

降级方案 ​

如果新版本导致问题：

  1. 使用便携版：下载旧版本的便携版（Portable）
  2. 回滚 Git：如果仓库由 Git 管理，可以检查变更
  3. 禁用问题插件：逐一排查插件兼容性
  4. 报告问题：在 Obsidian Forum 或 GitHub 报告

数据迁移 ​

仓库格式变更 ​

Obsidian 的仓库格式（Markdown 文件）非常稳定，但配置格式可能有变化：

文件变更频率说明
.md 笔记极少变标准格式
.canvas 白板极少变JSON 格式
app.json偶尔变应用配置
appearance.json偶尔变主题配置
community-plugins.json偶尔变插件列表
graph.json偶尔变图谱配置

迁移步骤 ​

text
1. 备份整个仓库
2. 安装新版本
3. 打开仓库
4. 检查笔记显示是否正常
5. 检查插件是否正常
6. 检查主题是否正常
7. 测试核心功能

配置迁移 ​

bash
# 备份配置
cp -r .obsidian/ .obsidian-backup/

# 如果需要恢复配置
rm -rf .obsidian/
cp -r .obsidian-backup/ .obsidian/

跨设备迁移 ​

从旧设备迁移到新设备 ​

  1. 方法一：云同步

    • 确保 Obsidian Sync 已同步所有文件
    • 在新设备登录同一账号
    • 下载同步数据

  2. 方法二：文件复制

    • 将整个仓库文件夹复制到新设备
    • 使用 U 盘或网盘传输

  3. 方法三：Git 克隆

    • 将仓库推送到 Git 远程仓库
    • 在新设备克隆仓库

迁移检查清单 ​

  • [ ] 所有笔记文件已迁移
  • [ ] 附件文件已迁移
  • [ ] 插件列表正确
  • [ ] 插件设置已同步
  • [ ] 主题和 CSS 片段已同步
  • [ ] 快捷键设置已同步
  • [ ] 模板文件夹已同步
  • [ ] 工作区布局已同步

常见问题 ​

更新后打不开仓库？ ​

  1. 尝试打开其他仓库确认是否为仓库问题
  2. 重命名 .obsidian 文件夹为 .obsidian.bak
  3. 重新打开仓库（会重建配置）
  4. 从备份恢复配置

更新后插件不工作？ ​

  1. 检查插件是否有更新
  2. 在开发者控制台查看错误信息
  3. 尝试禁用再启用插件
  4. 在 GitHub Issue 中搜索类似问题

如何回滚到旧版本？ ​

  1. 下载旧版本安装包
  2. 卸载当前版本
  3. 安装旧版本
  4. 注意：不建议长期使用旧版本

相关资源 ​