在实际使用 Obsidian 的过程中，Vault 是新手最容易误会的概念之一。很多教程会把它翻译成“知识库”“仓库”“库”，听起来像是一个需要专门创建的软件项目。但当你真正回到文件系统里，会发现 Vault 就是一个普通文件夹。Obsidian 做的只是把这个文件夹识别为笔记目录，并把配置信息写进这个目录下的隐藏配置文件夹。理解这句话，后面的一切操作都会顺理成章：备份 Vault 就是备份文件夹，迁移 Vault 就是复制文件夹，多端同步 Vault 就是同步文件夹。
1. Vault 的本质：它就是一个文件夹
1.1 先放下“知识库”这个词，直接看文件系统
Obsidian 对 Vault 的定义，本质上就是“一个被 Obsidian 读取并展示为知识库的文件夹”。翻译成中文可以叫“库”，也可以叫“仓库”，但最贴近真实的说法就是“文件夹”。
当你点击创建 Vault 时，Obsidian 并不是在某个数据库里新建了一张表，而是在你选择的路径下创建了一个文件夹，并在文件夹内部初始化.obsidian配置目录。之后你新建的每一篇笔记，都是这个文件夹下的.md文件。即使完全没有 Obsidian 软件，这些文件也仍然存在，可以用任意文本编辑器打开。
这个特性值得在第一天就牢牢记住：Obsidian 不是笔记的容器，文件系统才是。Obsidian 只是恰好能打开并编辑这些文件。Vault 不是一个看不见摸不着的“数据库”，它只是文件系统中的一个目录。
1.2 打开 Vault 后你实际看到的内容
用一个最小的 Vault 举例，它的真实目录结构大致如下：
MyVault/ ├── .obsidian/ │ ├── app.json │ ├── appearance.json │ ├── core-plugins.json │ ├── hotkeys.json │ ├── workspace.json │ ├── plugins/ │ ├── themes/ │ └── daily-notes.json ├── 笔记1.md ├── 笔记2.md ├── 附件/ │ └── 图片1.png └── .trash/.obsidian是隐藏目录，Windows 下需要在资源管理器里开启“显示隐藏的项目”，macOS 下需要按Command + Shift + .才能看到。这个目录存放的是 Obsidian 针对当前 Vault 的配置，而不是你的笔记内容。
注意：如果文件夹里看不到
.obsidian，先开启系统隐藏文件显示。Vault 缺少这个目录时不代表文件有问题，只表示 Obsidian 会以默认配置重新初始化它。
各部分作用可以整理成下表：
| 文件或目录 | 作用 |
|---|---|
笔记1.md | 用户创建的实际笔记 |
附件/ | 可配置的附件目录 |
.trash/ | 软删除时的回收目录 |
.obsidian/app.json | 编辑器、文件和链接等设置 |
.obsidian/workspace.json | 当前工作区打开的标签页和布局 |
.obsidian/plugins/ | 当前 Vault 启用的社区插件 |
.obsidian/themes/ | 当前 Vault 可用的主题 |
注意，.obsidian不是必须手动编辑的。绝大多数情况下，通过界面设置修改配置后，Obsidian 会自动写回对应的 JSON 文件。
1.3 为什么“把 Vault 当文件夹”能解决大多数困惑
很多 Obsidian 问题，只要切换到文件系统视角，马上能找到答案。
备份：想要备份笔记，不需要导出，不需要打包数据库，直接把整个 Vault 文件夹复制一份即可。因为所有内容都是普通文件。
迁移：换电脑时，把 Vault 文件夹复制到新电脑，再在 Obsidian 里选择“打开文件夹作为 Vault”，就可以还原全部笔记和配置。插件、主题、快捷键都跟着走。
同步：使用坚果云、iCloud、Syncthing、Git 等任何一种文件同步方案，同步的对象就是 Vault 文件夹。同步失败时，问题通常出在文件夹路径或文件冲突，而不是 Obsidian 本身。
排错：当 Obsidian 里的文件显示异常时，第一步永远是先打开文件管理器，看看这个文件是否真的存在、内容是否还是 Markdown 文本。如果文件系统里正常，再考虑配置问题。这条排查顺序能避开大量无用操作。
2. 创建 Vault 前先想清楚：位置、名称和目录规划
2.1 选位置：本地磁盘、外接设备还是同步目录
创建 Vault 时，大多数人会直接使用默认位置，很少思考路径选择。实际上，Vault 的位置直接决定后续备份和同步的成本。
常见选择如下：
| 存放位置 | 优点 | 风险 |
|---|---|---|
| 系统主目录（文档） | 路径简单，权限正常 | 如果系统重装可能被覆盖，需要提前备份 |
| 独立数据盘 | 与系统隔离，重装系统影响小 | 需要额外挂载和权限配置 |
| 移动硬盘或 U 盘 | 随身携带，换电脑方便 | 未安全弹出容易损坏文件，速度不稳定 |
| 网盘同步目录 | 天然多端同步 | 同步软件过滤隐藏目录时，配置可能丢失 |
这里有一个很容易犯的错误：不要把 Vault 建在 Obsidian 安装目录里，也不要把 Obsidian 软件安装目录当成 Vault。Obsidian 安装目录是程序文件，Vault 是你的数据目录，两者混在一起会让升级软件和备份数据都变得很别扭。
2.2 命名与目录规划
Vault 名称只是文件夹名，不需要承担知识体系分类的重任。你完全可以叫它my-vault、notes或知识库。真正需要规划的是文件夹内部的目录结构。
推荐的做法是保持目录层级浅一些，优先使用“文件夹 + 标签 + 双链”的组合。例如：
MyVault/ ├── 0 收件箱/ ├── 1 项目/ ├── 2 领域/ ├── 3 资源/ ├── 4 存档/ └── 附件/这种“收件箱到归档”的结构适合长期维护，但不要照搬，应该按自己的实际工作流调整。Obsidian 更擅长通过双链组织关系，而不是通过一层又一层文件夹去硬分类。文件夹层级超过 3 层后，维护成本会明显上升。
2.3 创建 Vault 的两种方式和验证方法
创建 Vault 有两种常见方式，效果相同。
第一种，在 Obsidian 启动界面点击“Create new vault”，输入名称并选择路径，Obsidian 会自动生成文件夹和.obsidian。
第二种，先在文件管理器中手动创建文件夹，然后打开 Obsidian，点击“Open folder as vault”，选择刚才创建的文件夹。Obsidian 检测到没有.obsidian时，会自动初始化配置目录。
手动创建文件夹的方式更符合“Vault 是文件夹”的直觉。在 Linux 或 macOS 终端里，也可以这样建目录：
mkdir -p ~/Documents/MyVault/附件注意：创建完成后，Obsidian 会自动生成
.obsidian。不需要自己手工创建配置目录，更不要从网上随意复制一份配置覆盖进去。
创建完成后，建议打开文件管理器，确认以下三个检查点：
- 文件夹出现在指定位置。
- Obsidian 界面能显示出该文件夹下的文件。
- 文件夹里已经自动生成
.obsidian目录。
如果.obsidian没有生成，说明 Obsidian 可能没有真正打开这个 Vault。更常见的原因是打开了 Vault 的父目录，而不是 Vault 本身。
3. 用文件管理器理解 Vault：笔记、双链和附件的关系
3.1 笔记文件就是普通 Markdown 文件
在 Vault 中，一篇笔记对应一个.md文件。Obsidian 的职责是渲染这些文件、维护它们之间的链接、提供搜索和插件能力。
这也意味着，你可以用 VS Code、Typora、记事本、手机文本编辑器等任何工具打开同一份笔记。只要文件内容符合 Markdown 语法，Obsidian 都能识别。
有一个实用技巧：当 Obsidian 打不开某个文件时，不要先怀疑软件，用文本编辑器直接打开这个.md文件。如果内容还在，说明文件本身没有损坏，问题通常出在 Obsidian 的索引或工作区状态。如果文件内容为空，才是文件损坏或被覆盖。
3.2 双链本质上是文件路径引用
Obsidian 的[[笔记名]]语法看起来是在引用一个“笔记对象”，但底层只是引用 Vault 内的一个文件路径。当你输入[[A]]时，Obsidian 会在当前 Vault 里找到名为A.md的文件并建立引用关系。
Obsidian 同时支持[[Wiki 链接]]和[相对链接](相对路径)两种写法。前者更易读，后者更通用，但实际解析时都要落到文件路径。
这个机制带来的好处是，复制整个 Vault 后，双链依然有效。它带来的坏处是，如果直接在文件资源管理器里重命名文件、移动文件，链接可能失效，因为 Obsidian 没有参与操作，无法自动更新引用。
所以日常操作建议遵循一条规则：重命名、移动、删除笔记时，优先在 Obsidian 内部完成。Obsidian 的自动更新链接机制只能覆盖它通过软件本身发起的文件操作。在文件管理器里操作，等于绕过了这个保护层。
3.3 附件应该统一存放，而不是散落在笔记旁边
笔记里插入的图片、PDF、音频等文件，如果在默认设置下直接拖入 Vault，很可能会放在根目录或当前笔记旁边。时间一长，目录会非常混乱。
Obsidian 提供了“附件默认存放路径”设置。在设置中搜索“文件与链接”，可以指定附件统一放入某个子目录，例如附件或assets。
一个典型的app.json片段如下：
{ "alwaysUpdateLinks": true, "attachmentFolderPath": "附件" }其中attachmentFolderPath表示附件默认路径，alwaysUpdateLinks表示自动更新链接。不同版本 Obsidian 的字段名可能略有差异，落地时以当前版本生成的配置为准，不需要手工记忆这些字段名。
把附件统一到同一个目录，可以显著降低同步冲突和备份遗漏的概率。否则，图片分散在几十个文件夹里，很难判断哪些文件属于这个 Vault。
4..obsidian配置目录：Vault 比普通文件夹多出来的部分
4.1.obsidian里到底存放了什么
如果 Vault 只是一个文件夹，那它和普通文件夹的区别是什么？答案是.obsidian。这是 Obsidian 在所有 Vault 内自动生成的特殊目录，用于保存当前 Vault 的配置。
主要文件如下：
| 配置文件名 | 作用 |
|---|---|
app.json | 编辑器、文件和链接相关设置 |
appearance.json | 主题、字体、界面外观设置 |
hotkeys.json | 自定义快捷键 |
core-plugins.json | 核心插件启用状态 |
community-plugins.json | 社区插件启用状态 |
workspace.json | 打开的面板、标签页、侧边栏布局 |
daily-notes.json | 日记插件设置 |
plugins/ | 社区插件本体 |
themes/ | 主题文件 |
这些文件都是 JSON 格式，用户可以阅读，但不推荐直接手工修改。界面设置会自动写回这些文件。
4.2 为什么复制整个 Vault 就能迁移配置
很多人迁移 Obsidian 时只复制了.md文件，换电脑后发现快捷键、主题、插件全没了。原因就是没有复制.obsidian。
只要把整个 Vault 文件夹复制到新位置，新电脑的 Obsidian 打开后，会读取.obsidian下的配置，从而还原大多数设置。插件本体只要在plugins目录里，也会直接可用。
需要注意的是，插件可能依赖特定版本的操作系统和 Obsidian 版本。迁移后如果某个插件无法启动，优先检查插件是否有版本要求，并在 Obsidian 社区插件列表里重新管理。
插件目录结构大致如下：
.obsidian/ └── plugins/ └── dataview/ ├── manifest.json ├── main.js └── styles.cssmanifest.json是插件的清单文件，记录插件 ID、名称、版本和所需 Obsidian 版本：
{ "id": "dataview", "name": "Dataview", "version": "0.5.67", "minAppVersion": "1.0.0", "description": "A plugin for querying notes" }实际版本号会持续变化，这里只用来展示文件结构，不要把它当作固定值。
4.3 插件和主题是“Vault 级”的，不是“软件级”的
这是新手最容易搞混的一点。Obsidian 软件本身更像一个空壳，社区插件和主题并不是全局安装在软件里，而是安装在当前 Vault 的.obsidian目录下。
所以同一个 Obsidian 软件，打开 Vault A 时看到一组插件，打开 Vault B 时可能看不到这些插件。如果 Vault B 没有对应的plugins目录，它就是一个没有插件的干净 Vault。
这个设计有利有弊。好处是不同 Vault 可以使用不同的插件组合，避免插件冲突。坏处是如果你以为插件是全局的，换了一个 Vault 后发现插件丢了，会误以为软件出了问题。排查时，第一步不是重新安装 Obsidian，而是确认当前 Vault 的.obsidian是否存在。
5. 多 Vault 管理：什么时候拆，什么时候合
5.1 单 Vault 与多 Vault 的取舍
用到一定程度后，不少人会考虑建第二个、第三个 Vault。要不要拆，取决于笔记之间的相互引用关系，而不是笔记量的大小。
对比表如下：
| 维度 | 单 Vault | 多 Vault |
|---|---|---|
| 双链引用 | 任意笔记之间都能互相链接 | 跨 Vault 无法直接[[链接]] |
| 插件管理 | 插件统一，配置简单 | 不同 Vault 可以隔离插件 |
| 搜索与图谱 | 全局搜索方便 | 只能搜索当前 Vault |
| 备份迁移 | 一个文件夹即可 | 每个 Vault 都要单独处理 |
| 同步复杂度 | 低 | 多个 Vault 路径分散，同步配置更繁琐 |
如果两个知识域会频繁互相引用，比如“项目经验”和“个人笔记”里都出现同一个技术方案，建议放在同一个 Vault。如果两个区域完全隔离，比如客户资料和私人日记，分开 Vault 能降低误操作和同步泄露的风险。
5.2 多设备同步时 Vault 的路径问题
Obsidian 并不要求不同设备上 Vault 的路径一致。你在电脑上放在D:\MyVault，在手机里可能放在应用的私有目录，这都不影响使用。Obsidian 保存的是 Vault 的绝对路径引用，但这个路径只在“打开 Vault”时使用，不会写入笔记内容。
所以在多设备同步中，不需要刻意让路径一致。真正需要注意的是避免两个设备同时打开同一个 Vault 并各自写入.obsidian配置，那样会造成工作区状态互相覆盖。更安全的做法是：在一台设备上编辑完成后，等待同步完成，再在另一台设备上打开。
注意：云同步环境下，等待同步完成再在另一台设备打开 Vault，能避免大量工作区冲突。
5.3 拆分 Vault 的推荐做法
如果决定把一个 Vault 拆成两个，不要在原来 Vault 中直接剪切整个目录，避免配置丢失。
推荐流程：
- 新建目标 Vault 文件夹。
- 用 Obsidian 打开新 Vault，先让它生成
.obsidian。 - 从原 Vault 复制笔记文件夹到新 Vault。
- 原 Vault 保留一段时间，确认新 Vault 工作正常后再删除。
- 如果希望新 Vault 也使用原来的主题和插件，把旧
.obsidian下的themes和plugins手动复制过去。
这样可以最大程度保留已有文件，同时避免一次操作导致全部设置丢失。
6. 常见问题排查：从文件系统视角定位 Obsidian 故障
6.1 排查优先级：文件是否还在 > 路径是否正确 > 配置是否正常
Obsidian 的问题表现很多，但排查顺序可以固定下来：
- 先用文件管理器检查笔记文件是否存在。
- 再用文本编辑器打开
.md文件，确认内容是否为 Markdown。 - 然后检查打开的是不是正确的 Vault 目录。
- 继续检查
.obsidian是否存在，社区插件是否启用。 - 最后查看 Obsidian 版本和插件版本是否兼容。
这五步已经能覆盖大多数问题。
6.2 常见问题与处理
| 问题现象 | 常见原因 | 检查方式 | 处理建议 |
|---|---|---|---|
| 打开 Vault 提示目录不存在 | Vault 被移动或删除 | 查看原路径是否还有文件夹 | 重新选择新的 Vault 路径 |
| 笔记内容还在但 Obsidian 不显示 | 文件被外部工具改名或移动 | 文件管理器查看文件列表 | 在 Obsidian 内重新打开或同步 |
| 图片全部无法显示 | 附件路径被改动 | 看笔记中的图片链接路径 | 统一附件目录并修正链接 |
| 删除笔记后无法恢复 | 删除到了系统回收站或永久删除 | 检查回收站、.trash | 从回收站恢复或从备份恢复 |
| 快捷键和主题消失 | 打开的是另一个 Vault | 检查.obsidian是否存在 | 切换到原 Vault 或复制配置 |
| 插件列表为空 | 当前 Vault 没有plugins目录 | 查看.obsidian/plugins | 重新安装插件或切回原 Vault |
这张表可以直接存成笔记，作为 Vault 排错清单。实际遇到问题时，先看表格中最符合的一条，再走对应路径。
6.3 安装包下载慢和应用商店版本问题
另一个高频现象是 Obsidian 安装包下载慢。这个问题和 Vault 本身无关，更多是网络链路问题。建议优先从 Obsidian 官网下载桌面版，或者使用手机系统自带应用商店获取移动版。下载中断时，可以先清理临时文件，再换一个网络时段重试。
不要因为下载慢就使用来源不明的第三方打包版本。安装包被篡改后，风险不会体现在 Vault 里，但会影响整个系统。遇到版本问题时，优先看官网的版本说明，而不是轻信转述。
关于收费，个人笔记场景并不需要付费；团队使用或商业场景落地前，应查看官网当前的许可说明，不要只依赖网上转述。
6.4 两个 Obsidian 同时打开同一个 Vault
这个场景很常见：桌面上开着一个 Obsidian，手机里又打开同一 Vault 开始写笔记。对于本地文件系统，这会造成.obsidian/workspace.json互相覆盖，表现为窗口布局经常乱跳、打开的面板不对。
解决方式很简单：同一时刻只让一个客户端以写入方式打开同一个 Vault。云同步环境下，也要避免同步还没完成就在另一台设备上强行打开。
7. 最佳实践：把 Vault 当成文件夹来管理
7.1 创建 Vault 前的检查清单
在给别人排错时，我建议在创建 Vault 前先过一遍这个清单：
- [ ] Vault 放在可读写且空间充足的磁盘分区。
- [ ] Vault 没有放在 Obsidian 安装目录下。
- [ ] 选择了一个容易记忆的路径，比如
~/Documents/MyVault。 - [ ] 预先决定附件统一路径，不要等到图片散落再整理。
- [ ] 确定备份方式，至少保证 Vault 文件夹有定期副本。
- [ ] 如果使用云同步，确认同步规则不会忽略隐藏目录和
.md文件。 - [ ] 笔记文件名尽量唯一，避免重名导致
[[双链]]歧义。
这份清单可以作为配置向导，每一条都对应一个潜在坑。
7.2 日常维护建议
把 Vault 当文件夹管理，意味着日常维护更要主动使用文件系统工具。
- 定期用文件管理器查看 Vault 目录，确认没有产生大量临时文件和异常文件。
- 重命名
.md文件时，尽量在 Obsidian 内操作，让自动更新链接生效。 - 大体积附件不要塞进 Vault。几百 MB 的视频、压缩包放进 Vault 后，同步和备份都会变慢。
- 备份策略不要只复制
.md，要连同.obsidian一起备份。 - 不要在同一条目录树里嵌套创建两个 Vault。嵌套 Vault 会让 Obsidian 的文件识别和链接解析变得混乱。
- 感觉界面卡顿或布局混乱时，可以先关闭当前 Vault，再重新打开。如果还不行，备份后删除
.obsidian/workspace.json让 Obsidian 重建工作区。
注意：嵌套 Vault 会导致文件归属混乱。一个文件夹层级中只应有一个 Vault 根目录。
7.3 可以继续扩展的方向
理解 Vault 是文件夹之后，很多扩展方向都会变得清晰：
- 用 Dataview 插件做查询：它本质是在 Vault 内的
.md文件里按条件筛选。 - 用 Git 做版本管理：把 Vault 作为 Git 仓库目录，提交记录的就是笔记文件的变化。
- 用 CSS 自定义主题：修改的是
.obsidian/themes下的样式文件。 - 用 Excalidraw 画图：生成的文件也是存放在 Vault 内的资源文件。
- 接入 AI 插件：多数实现是读取 Vault 内文件内容后调用外部接口，仍然离不开文件系统。
这些方向技术不同，但共同点是都建立在“Vault 是一个文件夹”的基础上。先把这个基础打牢，再考虑插件组合和自动化流程，会更稳定。
最后说一个对新手最有用的练习：不要只通过 Obsidian 的界面去认识 Vault。建好一个 Vault 后，用文件管理器打开它，把几篇笔记放进去，再用文本编辑器打开其中一篇，改几个字，保存，回到 Obsidian 刷新。你会发现 Obsidian 能识别这个变化。那一刻，Vault 的神秘感就彻底消失了，它确实只是一个文件夹。
