Vault（仓库）概念 · Obsidian 教程

第一次启动 Obsidian，它不会问你”要不要注册”，也不会塞给你一片云端服务器地址。它只会抛出一个朴素到近乎哲学的问题：你想把笔记放在哪个文件夹里？

这个文件夹，在 Obsidian 的世界里有一个专门的名字——Vault（仓库）。理解了 Vault，你也就理解了 Obsidian 一半的设计哲学。

一、Vault 的本质：一个文件夹即一个知识库

官方文档对仓库的定义干净利落：“仓库本质上是本地文件系统中的一个文件夹。” 你所有的笔记、附件、配置，统统住在这个文件夹里。没有数据库，没有专有格式，没有藏在云端的黑箱——就是普普通通的、可以用系统文件管理器随手点开的文件夹。

这带来几个意味深长的结果：

你的笔记是纯文本 Markdown 文件，任何时候都能用记事本、VS Code、Typora 任意一个编辑器打开。即便有一天你不再用 Obsidian，你的文字依然安安稳稳地躺在那里。
你可以用任何文件管理器来管理它们——复制、移动、打包、压缩，全凭你高兴。Obsidian 会自动侦测外部改动并刷新仓库。
数据主权彻底在你手里。官方明确说：“其他人无法读取，包括我们。“你的硬盘就是你的图书馆，离线也能高速访问。

首次打开 Obsidian，它会弹出一个选择面板，给你两条路：

路径一：创建一个全新的空仓库

一个干干净净的知识库就此诞生，等着你写下第一行字。

路径二：把现有文件夹作为仓库打开

Obsidian 会把这个文件夹”认领”为仓库，原有的文件原封不动地纳入管理。这对于从 Notion、Bear、Logseq 等工具迁移过来的人格外友好。

官方文档写得很清楚：“你可以将所有笔记保存在一个仓库里，也可以为不同的项目创建不同仓库”，“你可以将多个文件夹作为独立的仓库打开，例如将工作笔记和学习笔记分开管理。”

想换一个仓库？点左上角的仓库切换器（那个像保险柜的图标），就能在已知的仓库之间跳转，或新建/打开另一个。工作归工作，生活归生活，小说创作归小说创作——彼此物理隔离，互不打扰。

但有一条官方明确给出的忠告：不要在仓库里再嵌套仓库。因为内部链接的作用范围只限于单个仓库，嵌套会让链接无法正确更新。想让内容分块，用文件夹就够了，不必另开仓库。

当你创建或打开一个仓库时，Obsidian 会在仓库根目录下悄悄生成一个名叫 .obsidian 的隐藏文件夹。它就是仓库的”灵魂”——里面装着这个仓库专属的偏好设置：快捷键、主题、第三方插件、工作区布局，等等。

几个要点值得记住：

它默认是隐藏的。因为以英文句点（.）开头的文件夹会被大多数操作系统藏起来。想看到它：
- macOS：在访达里按 Cmd+Shift+.（句点）。
- Windows：在文件夹选项中开启”显示隐藏的文件”。
- Linux：在文件管理器里按 Ctrl+H。
它跟着仓库走。把整个仓库文件夹拷到 U 盘、塞进网盘，.obsidian 也会一并跟随，你的设置和插件在另一台电脑上几乎能原样复活。
用 Git 同步时要注意。.obsidian/workspace.json 和 workspaces.json 这两个文件记录着当前工作区布局，每次打开新文件都会更新，频繁变动会让 Git 提交记录很吵。官方建议把它们写进 .gitignore。

这里有个容易混淆的点，值得单独说清：Obsidian 的设置分两层。

仓库级设置存在 .obsidian 文件夹里，只对当前仓库生效。换个仓库，主题、插件、快捷键都可能不一样。
全局设置存在系统文件夹里（macOS 是 ~/Library/Application Support/obsidian，Windows 是 %APPDATA%\Obsidian\，Linux 是 ~/.config/obsidian/），管的是账号、登录态这类跨仓库的东西。

官方有一句重要警告：请勿在系统文件夹中创建仓库，否则可能导致数据损坏或丢失。仓库放哪都行，就是别放那儿。

理解了”一个文件夹即一个知识库”，下一站我们就要真正走进 Obsidian 的界面——左右侧栏、编辑区、命令面板，看看这台机器开动起来长什么样。