VS Code离线文档本质是本地Markdown文件+插件链+元数据管理；Foam支持双向链接与图谱且完全离线，需禁用其GitHub sync； snippet需开启markdown quickSuggestions；标签检索靠YAML frontmatter与正则搜索实现。
VSCode 本身不提供“离线文档”这个内置概念，所谓离线文档笔记，实际是指在无网络环境下，用 VSCode 编辑本地 Markdown 文件、配合插件和配置实现类文档库的写作、跳转、索引与组织能力。关键不在“离线”，而在「本地文件系统 + 合理插件链 + 手动/半自动元数据管理」。
用 Foam 实现双向链接与图谱，但必须离线可用
Feam 是目前最成熟的 VSCode 原生笔记扩展，依赖本地文件（.md）和 YAML frontmatter，完全不联网。它能生成文档关系图、支持 [[wikilink]]、按 tags 聚类，所有数据都在你自己的文件夹里。
- 安装时必须下载
foam-vscode-0.19.0.vsix（注意版本号匹配你的 VSCode，如 1.85+ 推荐 ≥0.19） - 不要启用
foam-core的 GitHub sync 功能——它默认会尝试拉取远程仓库，离线时会报错Failed to fetch repository - 初始化只需在工作区根目录建一个空文件夹，用命令面板运行
Foam: Initialize Foam Workspace，它会生成.foam/配置目录，不依赖任何外部服务 - 如果你已有旧笔记，把它们放进该工作区，Foam 会自动扫描
[[xxx]]和tags: [a, b]，无需联网索引
离线状态下让 snippet 模板真正生效
像 intensive_reading 这类自定义 Markdown 模板，离线时容易失效，根本原因是 VSCode 默认关闭了 Markdown 语言的快速建议（editor.quickSuggestions）。
- 手动打开用户设置（
Ctrl+,），搜索markdown editor.quickSuggestions，勾选other和strings - 或直接编辑
settings.json，加入：[markdown] { "editor.quickSuggestions": { "other": true, "comments": false, "strings": true } } - 确认插件已通过
code --install-extension xxx.vsix安装成功，且未被"extensions.ignoreRecommendations": true静默禁用 - 输入触发词后没反应？试试把光标移到行首再输，部分 snippet 不响应行中补全
不用联网也能做标签检索和全文搜索
VSCode 内置搜索（Ctrl+Shift+F）本身就是离线的，但想按 tags 快速筛选，得靠约定+过滤技巧。
- 统一在每篇笔记顶部写 YAML frontmatter，例如：
--- tags: [Flink, SQL, debugging] date: 2026-09-28 ---
- 搜索
tags: \[.*Flink.*\]（正则模式开启），就能列出所有含 Flink 标签的文件 - 用
!node_modules !.git排除干扰目录，避免搜到依赖或 Git 记录 - 别依赖插件做 tag tree——多数 tag 可视化插件（如 Tag Tree）需联网拉图标或初始化远程 schema，离线时空白或报错
真正卡住离线笔记体验的，往往不是功能缺失，而是某些插件悄悄启用了网络检查（比如自动更新提示、遥测上报、字体 CDN 加载）。装完每个 .vsix 后，进 Extensions 面板点右键 → Extension Settings，关掉所有带「telemetry」「update」「cloud」「sync」字样的选项。否则看似离线，实则启动就卡在 DNS 超时上。
