# Obsidian 剪藏插件的常见问题与解决方法
整理 Obsidian Web Clipper 找不到保管库、保存位置不对、只有标题没有正文，以及 iPhone、iPad 无法剪藏的检查步骤。
Canonical: https://21obsidian.com/blog/obsidian-web-clipper-faq
Image: https://pic.eryinote.com/PicGo/20260915201748-1-obsidian-web-clipper-faq-cover.webp
这篇文章整理了使用 Obsidian Web Clipper 时可能遇到的保存、正文和图片问题，可以直接找到对应的情况，按步骤检查。

还没有完成插件设置，请先阅读 [安装与基础设置教程](/blog/obsidian-web-clipper-setup)。使用 [FLO.W Obsidian 模板](https://21obsidian.com/) 的用户，可以结合 [剪藏使用教程](/docs/info-clipping) 设置保存位置和属性。

## 一、提示找不到保管库 \{#vault-not-found}

如果出现 `Vault not found` 或 `Unable to find a vault for the url`，先检查扩展中填写的库名是否与 Obsidian 一致。

1. 打开 Obsidian，确认准备保存文章的保管库名称。

2. 进入 Web Clipper 的「常规」设置，在「保管库」中填写这个名称，按回车添加。

3. 回到剪藏面板，选择刚刚添加的保管库，再保存一次。

这里填写的是库名，无须填写电脑上的完整路径。使用 [FLO.W Obsidian 模板](https://21obsidian.com/) 且没有改名时，填写 `FLO.W Obsidian`；保存文件夹另行设置，不要和库名写在一起。

具体操作见 [选择保管库](/blog/obsidian-web-clipper-setup#choose-vault)。

## 二、笔记没有保存在想要的文件夹 \{#wrong-folder}

保存位置需要在剪藏模板里设置。

1. 打开剪藏面板，查看当前使用的模板名称。

2. 进入扩展设置，选择这份模板，在「位置」中的「笔记位置」填写保存文件夹。

3. 回到剪藏面板，确认模板和文件夹都选对，再保存文章。

**[FLO.W Obsidian 模板](https://21obsidian.com/)用户填写 `信息`**；其他用户填写自己想要保存剪藏的文件夹。具体操作见 [设置剪藏模板](/blog/obsidian-web-clipper-setup#clipper-template)。

如果只在某些网站出现这个问题，留意剪藏面板是否自动换成了另一份模板。不同模板可以使用不同的保存位置。

## 三、点击添加后，保管库里没有新笔记 \{#no-new-note}

点击「添加到 Obsidian」后，浏览器可能会询问是否打开 Obsidian。需要允许打开，才能继续把文章交给 Obsidian 保存。

如果刚才点击了取消，回到原网页重新剪藏，在弹窗中选择打开 Obsidian，然后到目标文件夹检查新笔记。

第一次保存时，打开笔记看一下正文是否完整。剪藏面板关闭，并不代表文章已经保存成功。

## 四、保存后只有标题，没有正文 \{#title-only}

先打开剪藏面板，检查正文预览。

如果预览里就没有完整内容，先看 [正文没有提取完整](#incomplete-content)。如果预览正常，再检查当前模板的「笔记内容」是否保留了 `{{content}}`，填写方法见 [设置剪藏模板](/blog/obsidian-web-clipper-setup#clipper-template)。

**iPhone 或 iPad 用户**，继续检查 [接收剪藏内容的权限](#ios)。

**Linux 用户**，还需要检查 Obsidian 是否能读取剪贴板。可以先把 Obsidian 打开并切到前台，再尝试保存。如果仍然只有标题，可在 Web Clipper 的「常规」设置中尝试开启 `Legacy mode`；这种方式可能限制可保存的文章长度，不适合作为所有情况的默认设置。

## 五、正文没有提取完整 \{#incomplete-content}

Web Clipper 会尝试提取网页中的文章正文，但不同网站的页面结构不同，有时会漏掉需要的内容。

如果只保存了一小段，先检查网页上是否选中了文字或留下了高亮。想保存整篇文章时，取消不需要的选区或高亮，再打开扩展检查预览。

如果仍然漏掉某段内容，可以在原网页中选中需要的文字，再打开扩展保存。经常剪藏同一个网站时，也可以为它单独设置模板。

使用自定义模板时，检查「笔记内容」中的变量：`{{content}}` 用于提取正文、高亮或选中内容，`{{selection}}` 用于提取选中的文字。更多变量见 [变量表查询](/blog/obsidian-web-clipper-setup#variables)。

## 六、断网后，笔记里的图片不显示 \{#offline-images}

Web Clipper 默认保留图片的网络地址，不会自动把图片文件下载到保管库。需要离线阅读时，可以在保存文章后，再下载图片。

1. 在 Obsidian 中打开这篇笔记。

2. 按 `⌘P`（Mac）或 `Ctrl+P`（Windows）打开命令面板。

3. 输入「下载」，选择「下载当前文件内的所有附件」，完成后检查图片是否正常显示。

具体操作见 [下载附件的实机图解](/blog/obsidian-web-clipper-setup#offline-images)。

如果图片在剪藏预览里就没有出现，先检查 [正文提取情况](#incomplete-content)。下载附件只能处理笔记中已有的图片链接。

## 七、iPhone 或 iPad 无法使用剪藏 \{#ios}

在 Safari 中使用 Web Clipper 时，先确认扩展已经开启，再检查权限。

1. 打开 Safari 地址栏的页面菜单，点击「管理扩展」，开启 Obsidian Web Clipper。

2. 如果当前网站无法使用，进入系统「设置 → App → Safari → 扩展」，找到 Web Clipper，允许它在需要剪藏的网站上运行。

3. 如果能打开扩展，却无法把内容保存到 Obsidian，进入系统「设置 → App → Obsidian」，将「从其他 App 粘贴」设为「允许」。

设置完成后，回到 Safari 重新保存一篇文章，再到 Obsidian 检查结果。

## 相关阅读 \{#further-reading}

- [Obsidian Web Clipper 安装与基础设置教程](/blog/obsidian-web-clipper-setup)
- [信息剪藏](/docs/info-clipping)