foam仅提供双向链接基础能力，图谱可视化需额外配置或外部工具；[[补全失效因配置缺失、启动方式错误、路径不符或插件冲突；链接跳转要求文件名完全匹配；图谱视图依赖graphviz且易受性能限制。

Foam 不是“开箱即用的知识图谱”，它只提供双向链接基础能力，图谱可视化得靠额外配置或外部工具。

Foam 插件装完为啥 [[ 不自动补全？

常见错误现象：输入 [[ 后无提示、按 Tab 无反应、新建文件不生成链接锚点。

• 确保工作区根目录下有 foam.json 或 .foam/config.json（至少含 {"wikiRoot": "."}）
• VSCode 必须以「文件夹打开」方式启动项目，不能只打开单个 .md 文件
• 检查当前文件是否在 wikiRoot 路径内 —— Foam 默认只扫描该路径下的 .md 文件
• 禁用其他 Markdown 插件冲突（如 Markdown All in One 的链接补全功能需关闭）

如何让 [[笔记名]] 真正变成可跳转的双向链接？

使用场景：写笔记时想快速关联已有主题，且点击后能跳转、右键能查反向引用。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• 链接目标文件名必须和 [[ 中的文本**完全一致**（包括大小写、空格、连字符），不支持模糊匹配
• 若目标文件名为 前端性能优化.md，则必须写 [[前端性能优化]]，写 [[前端 性能优化]] 或 [[前端性能优化.md]] 均无效
• 反向链接面板（Ctrl+Shift+P → Foam: Show Backlinks）只显示当前文件被哪些文件用 [[ 引用过，不包含 [](url) 或普通文字提及
• 首次创建新链接后，需保存文件并等待几秒，Foam 才完成索引更新（状态栏右下角会显示 “Indexing…”）

为什么 graphviz 或 foam-vscode 自带图谱视图一片空白？

性能 / 兼容性影响：Foam 本身不渲染图谱，所谓“图谱”是靠 VSCode 插件调用 Graphviz 或 Webview 渲染的附加功能，极易失效。

• foam-vscode 内置的 Graph View 需要本地安装 Graphviz 并将 dot 加入系统 PATH，Windows 用户常卡在这步
• Mac 上用 brew install graphviz 后，仍需重启 VSCode（仅重载窗口不够）
• 图谱节点数量超过 200 个时，Webview 渲染明显卡顿，缩放/拖拽易失灵 —— 这不是 bug，是浏览器渲染瓶颈
• 更可靠的做法是导出为 foam export --format=dot，再用 dot -Tpng graph.dot -o graph.png 静态生成，适合归档或分享

双向链接的“活”取决于你维护链接命名的一致性，而不是插件有多智能。Foam 不会帮你猜你想连哪篇笔记，也不会自动合并同义词条目 —— 这部分得自己定规范、守规矩。