Obsidian 学习笔记

Appearance

安装与配置问题 ​

这里汇总了 Obsidian 安装和配置过程中最常见的问题。

📥 下载与安装 ​

Obsidian 支持哪些操作系统？ ​

Obsidian 支持以下操作系统：

平台最低版本下载方式
WindowsWindows 10+官网/应用商店
macOSmacOS 10.15+官网/App Store
Linux主流发行版官网/Flatpak/Snap
iOSiOS 14+App Store
AndroidAndroid 8.0+Play Store/APK

如何下载 Obsidian？ ​

官方渠道：

  1. 官网：https://obsidian.md
  2. GitHub：https://github.com/obsidianmd/obsidian-releases
  3. 应用商店：各平台官方应用商店

⚠️ 注意

请务必从官方渠道下载，避免使用第三方来源的安装包。

安装时提示权限错误怎么办？ ​

Windows：

bash
# 解决方案：
1. 右键以管理员身份运行
2. 关闭杀毒软件后重试
3. 检查安装路径是否有特殊字符

macOS：

bash
# 如果提示"无法打开，因为它来自身份不明的开发者"：
1. 系统偏好设置 → 安全性与隐私 → 仍要打开
2. 或在终端执行: xattr -cr /Applications/Obsidian.app

Linux：

bash
# 如果提示权限问题：
sudo chmod +x obsidian.AppImage
# 或使用 Flatpak/Snap 安装

如何在多台设备上安装？ ​

mermaid
graph TD
    A[选择同步方案] --> B{官方同步?}
    B -->|是| C[购买同步服务]
    B -->|否| D[配置第三方同步]
    C --> E[在各设备登录]
    D --> E
    E --> F[下载远程仓库]
    F --> G[开始使用]

🗂️ 仓库管理 ​

什么是仓库（Vault）？ ​

仓库是 Obsidian 存储笔记的文件夹，包含：

  • 笔记文件（.md）
  • 附件文件
  • 配置文件（.obsidian 文件夹）
  • 插件和主题

如何创建新仓库？ ​

方法一：创建空仓库

  1. 点击"创建新仓库"
  2. 选择存储位置
  3. 输入仓库名称
  4. 点击创建

方法二：打开现有文件夹

  1. 点击"打开文件夹作为仓库"
  2. 选择包含 .md 文件的文件夹
  3. Obsidian 会自动识别

如何迁移仓库到新位置？ ​

步骤：

  1. 关闭 Obsidian
  2. 复制整个仓库文件夹到新位置
  3. 打开 Obsidian，选择"打开文件夹作为仓库"
  4. 选择新位置的文件夹

⚠️ 重要

确保复制完整的 .obsidian 文件夹，否则配置和插件会丢失。

如何在多台电脑间共享仓库？ ​

推荐方案：

方案优点缺点
Obsidian Sync官方支持，稳定需付费
Git + Obsidian Git免费，版本控制需技术基础
iCloud/OneDrive简单可能有冲突
Syncthing免费，P2P需配置

⚙️ 初始配置 ​

首次使用需要配置什么？ ​

基础配置清单：

yaml
必做:
  - 选择外观主题
  - 设置默认编辑器模式
  - 配置附件存储位置
  
推荐:
  - 启用核心插件（日记、模板等）
  - 设置快捷键
  - 配置备份方案
  
可选:
  - 安装第三方插件
  - 自定义 CSS
  - 配置同步

如何设置中文界面？ ​

  1. 打开设置 → 外观
  2. 找到"语言"选项
  3. 选择"简体中文"
  4. 重启 Obsidian

如何配置附件存储？ ​

推荐设置：

  1. 设置 → 文件与链接
  2. "新附件的默认位置"选择"指定文件夹"
  3. 设置文件夹路径，如 Attachments/

按年月归档：

Attachments/
├── 2024/
│   ├── 01/
│   ├── 02/
│   └── ...

如何设置自动备份？ ​

使用 Obsidian Git 插件：

  1. 安装 Obsidian Git 插件
  2. 配置 Git 仓库
  3. 设置自动备份间隔（建议 10-30 分钟）
  4. 配置自动推送

🔧 高级配置 ​

如何导入其他笔记软件的数据？ ​

来源导入方法
Notion使用导入插件或 Markdown 导出
Evernote使用导入插件
Roam Research导出为 Markdown
Logseq直接打开文件夹
印象笔记使用第三方转换工具

如何重置 Obsidian 配置？ ​

方法一：删除配置文件夹

bash
# 关闭 Obsidian 后删除
.obsidian/

# 重启后会生成默认配置

方法二：仅重置特定配置

bash
# 只删除主题配置
.obsidian/themes/
.obsidian/appearance.json

# 只删除插件配置
.obsidian/plugins/

如何导出配置？ ​

手动导出：

  1. 复制 .obsidian 文件夹
  2. 保存到安全位置

使用插件导出：

  1. 安装"Settings Export"插件
  2. 导出配置为 JSON 文件

❓ 其他问题 ​

安装后打开是空白页面？ ​

解决方案：

  1. 检查是否安装了最新版本
  2. 清除缓存后重启
  3. 尝试以兼容模式运行（Windows）
  4. 检查是否被防火墙阻止

如何查看 Obsidian 版本？ ​

  1. 打开设置 → 关于
  2. 查看当前版本号

如何更新到最新版本？ ​

自动更新：

  • 桌面端：设置 → 关于 → 检查更新
  • 移动端：应用商店自动更新

手动更新：

  • 下载最新安装包
  • 直接覆盖安装（配置不会丢失）

卸载后笔记会丢失吗？ ​

不会！ 你的笔记存储在仓库文件夹中，不在软件安装目录。卸载 Obsidian 不会删除笔记。

💡 建议

卸载前记住仓库位置，重装后直接打开该文件夹即可。

🔗 相关链接 ​

💡 提示

如果以上内容没有解决你的问题，请查看故障排查指南或在社区求助。

最后更新：2026年3月13日编辑此页反馈问题