下载安装与创建第一个 vault

Obsidian 支持所有主流桌面和移动平台，安装过程本身很简单，真正值得讲清楚的是「vault 怎么建、建在哪、叫什么名字」——这些早期决定会影响你之后几年的使用体验。本章按 Windows、macOS、Linux 和移动端分别说明安装步骤，然后带你完成第一个 vault 的创建。

桌面端安装

所有平台的安装包都从官方下载页 https://obsidian.md/download 获取，请避免第三方下载站的二次打包版本。

Windows：在下载页选择 Windows 下的 Universal 下载安装文件，双击运行并按提示完成，之后像普通应用一样打开即可。

macOS：下载 Universal 安装包，打开后把 Obsidian 拖入 Applications 文件夹。首次打开若提示「来自未识别开发者」，在系统设置的隐私与安全里放行一次即可。

Linux 提供三种官方打包方式，按你习惯的包管理器选择：

# Snap 方式（--dangerous 是因为 Canonical 未审核该包，--classic 允许访问沙箱外的笔记目录）
snap install obsidian_<version>_<arch>.snap --dangerous --classic

# AppImage 方式
chmod u+x Obsidian-<version>.AppImage
./Obsidian-<version>.AppImage --no-sandbox

# Flatpak 方式
flatpak install flathub md.obsidian.Obsidian
flatpak run md.obsidian.Obsidian

在 Chromebook 上用 AppImage 运行前需要先安装 libnss3-dev，否则会报缺少共享库的错误。

移动端安装

• iOS / iPadOS：在 App Store 搜索 Obsidian，点「获取」安装。
• Android：在 Google Play 安装，或从官方下载页获取 APK 文件。官方支持 Android 5.1 及以上版本。

移动端的详细差异（小组件、快速捕捉、存储位置选择等）会在「移动端使用」一章展开，这里只需装好应用。

第一次启动：两个选择

首次打开 Obsidian，会要求你添加一个 vault，有两个选项：

1. Create new vault（创建新仓库）：填一个仓库名称，用 Browse 选择创建位置，点 Create 完成。适合全新开始。
2. Open folder as vault（把现有文件夹作为仓库打开）：如果你已有整理好的 Markdown 文件夹（比如从别的软件迁移过来的），直接选中它即可，Obsidian 会识别其中的 .md 文件。

另外还有一个 Sandbox vault（沙盒仓库）选项，相当于官方提供的练习场，里面预置了各类功能的示例，随便折腾不影响你的真实数据。它通过左侧栏仓库切换器旁的帮助图标或命令面板的「Open sandbox vault」打开，关闭对应的 Obsidian Sandbox 窗口即退出。移动端没有沙盒仓库。

vault 的本质与命名建议

vault 就是硬盘上的一个普通文件夹，里面放着你的笔记和一个 .obsidian 配置文件夹（存放主题、插件、快捷键等该仓库专属的设置）。这个以点开头的文件夹默认被系统隐藏：macOS 在 Finder 里按 Cmd+Shift+. 显示，Linux 多数文件管理器按 Ctrl+H，Windows 需在文件夹选项里开启「显示隐藏的项目」。

关于建几个 vault、怎么命名，给你几条经过大量用户验证的建议：

• 新手从一个 vault 开始。多仓库会把双链网络人为切断，等积累到几千条笔记再考虑拆分也不迟。
• 名字用英文并保持简短，如 MyVault、Notes。虽然 Obsidian 支持中文路径，但同步工具和脚本对中文路径的兼容性参差不齐。
• 位置避开自动同步目录。不要把 vault 直接建在 iCloud、OneDrive 等云盘的默认同步文件夹里，除非你明确采用该云盘作为同步方案——否则容易出现文件冲突。这个问题在同步方案对比一章会详细讨论。
• 不要嵌套仓库。官方明确不建议在一个 vault 里再套一个 vault，因为链接是仓库级别的，嵌套会导致链接更新异常。

完成后的第一分钟

vault 建好后，别急着研究设置。建议立刻做三件事：

1. 用 Ctrl+N（macOS 为 Cmd+N）新建一篇笔记，随便写点什么。
2. 再建一篇笔记，输入 [[ 试试链接第一篇——这是 Obsidian 灵魂功能的第一次体验。
3. 按 Ctrl+P（macOS 为 Cmd+P）打开命令面板，感受一下这个软件的所有功能都可以被搜索和执行。

如果你使用期间担心数据安全，可以先去设置里确认核心插件 File recovery（文件恢复）处于开启状态——它会定期自动保存快照，误删内容时能找回来。不过请注意，快照保存在本机，它不能替代真正的备份方案。

常见安装问题速查

装好并建好仓库后，下一章带你把界面每个角落认一遍——认识工具是高效使用的前提。

更新与版本管理

Obsidian 更新很勤，建议保持新版。桌面端检查路径：设置 → About → 检查更新，或点左下角齿轮图标；应用内更新会自动下载并提示重启。喜欢尝鲜的用户可以购买 Catalyst 许可证获取 Insider（抢先体验）版本，普通用户用稳定版即可。

更新前两点提醒：第一，更新不影响 vault 数据——笔记在仓库文件夹里，与应用本体分离，这也是本地优先架构的好处；第二，如果依赖某些社区插件，大版本更新后先观察插件的兼容通告，个别插件在新版 Obsidian 上可能短暂失效，等待插件作者跟进即可。

关于「要不要多仓库」的提前思考

虽然前文建议新手从一个仓库开始，但你迟早会遇到这个选择，提前把判断标准立好：按「数据边界」拆，不按「主题」拆。工作与个人合规隔离、家庭成员共用一台电脑、某个领域需要完全独立的插件环境——这些是合理的拆分理由。而「工作笔记和生活笔记」这种程度的区分，用一个仓库里的两个文件夹就足够了。

多仓库的操作都在左下角的仓库切换器里：Manage Vaults 窗口可以创建、打开、重命名、移动甚至从列表移除仓库。重命名仓库会同步重命名底层文件夹，移动仓库用自带的 Move vault 功能更安全。每个仓库的插件、主题、快捷键互相独立，互不干扰。

上手第一周的建议路线

给出一个经过验证的一周节奏，帮你把安装的热情转化为真正的使用习惯：

第一周结束时的成功标准很简单：你打开 Obsidian 不需要思考「该点什么」。至于模板、Dataview、PARA 这些进阶内容，本书后面的章节会按需登场，现在完全不用急。

移动端安装的补充说明

手机端安装还有几个桌面端没有的决策点，提前说明避免踩坑。Android 用户会遇到的第一个选择是安装来源：Google Play 或官方 APK。Play 商店版更新自动，是多数人的选择；APK 适合无法访问 Play 的环境，但需要自行跟进版本更新并允许系统安装未知来源应用。iOS 用户注意首次启动后的仓库创建界面：新建仓库时有一个「Store in iCloud」开关，勾选后仓库放在 iCloud Drive 的 Obsidian 专属目录里，这是苹果生态同步的官方推荐位置。

两端的首次启动都建议先不做任何配置，直接体验默认状态，等读完移动端使用一章再回头按需调整。特别提醒使用「应用锁定」（iOS 的 Require Face ID）功能的用户：开启后台，桌面小组件和快速捕捉将不可用——安全与便捷的取舍，按自己的场景定。

最后是空间预算：Obsidian 应用本体不大（数百 MB 级），但 vault 会随附件增长。手机上建仓库前想清楚附件策略——图片、PDF 这类大户建议留在桌面端或走云存储，移动端以文字笔记为主，这是移动端长期保持流畅的关键。

延伸阅读：工具安装只是第一步，用起来之后的效率功夫在别处——HBuilderX 效率技巧与提效手册 展示了另一款国产工具的提效思路，值得对照；想了解命令行玩家如何配置工作环境，可读 Claude Code 完全指南。

本章由 WorkBuddy 原创整理，功能行为依据 Obsidian 官方帮助文档。