VSCode离线文档无法加书签，因插件依赖编辑器模型（需editor.glyphMargin启用及语言服务注册），而离线HTML/PDF转Markdown等常被识别为只读或外部内容，导致装饰器API不加载、命令不注册；可行方案包括手动设置语言模式、用// BOOKMARK:注释配合全局搜索，或导入为工作区启用持久化。
VSCode 本身不支持离线文档（比如本地打开的 file:/// 协议 HTML、PDF 转换的 Markdown、或未纳入工作区的纯文本）的书签功能——alefragnani.bookmarks 插件默认只对「被 VSCode 视为编辑器文件」的打开文档生效，而离线文档常被识别为只读视图或外部内容，书签图标和命令会静默失效。
为什么离线文档加不了书签？
根本原因不是插件没装，而是 VSCode 的编辑器模型限制：bookmarks 依赖 editor.glyphMargin 和语言服务注册，而离线 HTML/Markdown 文件若未关联语言模式（如没设 html 或 markdown），或以只读方式打开（比如直接双击系统打开），VSCode 就不会加载装饰器 API，Toggle Bookmark 命令压根不注册。
常见现象包括：
- 右键行号区域看不到
Toggle Bookmark菜单项 -
Ctrl+Shift+P输入Bookmarks: Add Bookmark不出现 - 即使手动在
settings.json开了"bookmarks.persistAll": true，也无效果
能绕过限制的两种实操路径
不是所有离线文档都不可标记，关键看它是否被 VSCode 当作「可编辑资源」加载：
-
路径必须是
file://且文件名带合法扩展名：比如guide.html、notes.md；file:///tmp/doc（无后缀）或file:///tmp/index.htm（非标准后缀）大概率失败 - 必须用 VSCode 打开，而非系统默认浏览器：右键 →「在 VSCode 中打开」，或拖进已运行的 VSCode 窗口；双击直接用系统默认程序打开的，VSCode 根本不接管
-
手动设置语言模式：打开文档后，状态栏右下角点击当前语言（可能是
Plain Text），选HTML或Markdown；只有这时editor.glyphMargin才可能启用
替代方案：不用书签插件也能“标记”离线文档
当插件彻底失效时，靠原生能力做轻量锚点更可靠：
-
用
// BOOKMARK:注释打标：在 HTML 的<script>块里、或 Markdown 的 HTML 注释<!-- BOOKMARK: init-section -->中插入标记；之后用Ctrl+Shift+F全局搜BOOKMARK:即可跳转 -
利用大纲视图（Outline）：对 HTML，确保有
<h1>–<h6>标题；对 Markdown，用# 标题；VSCode 会自动生成大纲，Ctrl+Shift+O可快速导航 -
导出为工作区再启用书签：新建空文件夹 → 把离线文档复制进去 → 用 VSCode 打开该文件夹（作为工作区）→ 此时
.vscode/settings.json可写入"bookmarks.persistAll": true，书签才真正落地
最易被忽略的一点：离线文档的书签一旦创建成功，它绑定的是绝对行号，不是内容。如果文档后续被外部工具修改（比如自动格式化 HTML），行号偏移，书签就失效——这时候，// BOOKMARK: + 全局搜索才是唯一稳态方案。
