根本原因是工作区未初始化为dendron仓库，需执行npx dendron-cli init生成dendron.yml、docs/和workspace.code-workspace三要素，并用vscode打开根目录而非子文件夹。
Dendron 插件装了但命令面板里找不到 Dendron 命令？不是插件问题，是工作区根本没被识别为 Dendron 仓库。
为什么 Dendron: Initialize Workspace 命令灰掉或报错
VSCode 插件不会自动创建项目结构。Dendron 必须检测到三要素才激活：根目录下存在 dendron.yml、docs/ 目录、workspace.code-workspace 文件。缺一不可。
- 直接用 VSCode 打开一个空文件夹 → 插件不响应，所有命令灰掉
- 在终端中执行
npx dendron-cli init（需已安装 Node.js），它会生成上述三要素 - Windows 用户若在 PowerShell 中执行失败，换 CMD 或 Git Bash；Mac/Linux 注意
/usr/local/bin权限是否阻止全局二进制写入 - 执行完后，**必须用 VSCode 打开该文件夹的根目录**（即含
dendron.yml的那一层），不能只打开docs/子目录
dendron.newNote 报 “No workspace root found” 怎么办
这个错误和上一条本质相同，只是触发更隐蔽：你大概率打开了子目录，而非工作区根目录。
- 检查 VSCode 左下角状态栏 —— 如果没有 Dendron 图标和 vault 名称，说明未加载成功
- 右键资源管理器中的文件夹名 → “Reopen Folder in Workspace” → 确保路径指向含
dendron.yml的目录 - 如果之前混用了 Obsidian，注意别让
.obsidian/和docs/同级共存，Dendron 会拒绝加载 - 想绕过命令面板快速建笔记？右键侧边栏
Notes视图里的 vault 名称 → “New Note”
![[xxx]] 链接不跳转、预览不渲染
不是语法错了，是路径解析失败。Dendron 对命名和层级极其敏感。
-
xxx必须是目标笔记的 **basename**（不含.md），且大小写、连字符、下划线必须完全一致：My-Note.md只能写![[My-Note]]，![[my-note]]失效 - 跨 vault 链接需加前缀，如
![[vault2.foo.bar]]，前提是vault2已在dendron.yml中正确定义并启用 - 确认你点的是 Dendron Preview（蓝色方块图标），不是 VSCode 原生的 Markdown Preview（白色纸张图标）
- 链接高亮失效？很可能是启用了
enableWorkspaceTrust却未信任工作区 —— 点击左下角锁形图标，手动设为“受信任”
不用 Dendron 也能搭知识库？可以，但得接受限制
纯 VSCode + Markdown All in One + Git 是轻量可行的方案，但它不提供 Dendron 那类原生支持的层级导航、反向链接、跨 vault 管理等能力。
- 标准 Markdown 链接如
[API 设计原则](./02-ref/api-design-principles.md)可跳转，但无法自动生成 Backlinks - Ctrl+Click（macOS 是 Cmd+Click）可快速打开链接目标，但无法可视化关系图谱
- 所有笔记必须严格 UTF-8 无 BOM，文件名禁用空格/中文，推荐用短横线（
20240520-async-caching.md） - 一旦知识量超过几千篇，手工维护链接和结构的成本会指数上升 —— 这正是 Dendron 要解决的核心问题
真正卡住人的从来不是“怎么初始化”，而是初始化后忘了检查左下角有没有 Dendron 图标，或者把 docs/ 当成根目录打开 —— 这两个动作几乎占了新手问题的 70%。
