根本原因是工作区未初始化为dendron仓库，需先执行npx dendron-cli init创建dendron.yml、docs/和workspace.code-workspace三要素，并用vscode打开根目录而非子文件夹。
为什么 Dendron 插件装了却看不到命令面板里的 dendron 命令
根本原因通常是工作区没正确初始化为 Dendron 仓库，不是插件没装好。VSCode 插件本身不自动创建项目结构，必须手动初始化或打开已有 Dendron 工作区。
- 确保你已通过终端在空文件夹中执行
npx dendron-cli init（需提前装 Node.js 和npx），否则Dendron: Initialize Workspace命令会灰掉或报错Command 'Dendron: Initialize Workspace' resulted in an error - 不要直接用 VSCode 打开一个普通文件夹后点插件按钮——Dendron 不识别“未声明”的目录，必须先有
workspace.code-workspace+dendron.yml+docs/目录这三要素 - Windows 用户容易卡在权限问题：如果用 PowerShell 运行
npx失败，换 CMD 或 Git Bash；Mac/Linux 注意/usr/local/bin权限是否阻塞了全局二进制生成
新建笔记时 dendron.newNote 报错 “No workspace root found”
这个错误和上一条本质相同，但触发场景更隐蔽：你可能打开了子文件夹（比如只打开了 docs/），而不是整个工作区根目录。
- 务必用 VSCode 打开的是包含
dendron.yml的那一层文件夹，不是它的子目录 - 检查左下角状态栏是否有 Dendron 图标和当前 vault 名称，没有就说明没加载成功
- 如果之前用过其他笔记工具（如 Obsidian），注意别把
.obsidian/和docs/混在同一级——Dendron 会拒绝加载含冲突配置的目录 -
dendron.newNote默认行为依赖lookup模式，若想快速建平级笔记，可右键侧边栏Notes视图中的 vault 名称，选New Note，绕过命令面板
笔记之间用 ![[xxx]] 链接不跳转，预览也不渲染
这是路径解析失败的典型表现，Dendron 对命名和层级非常敏感，不是语法写对就能用。
-
![[xxx]]中的xxx必须是笔记的 **basename**（不含扩展名），且大小写、连字符、下划线必须完全一致，My-Note.md只能用![[My-Note]]，不能写![[my-note]] - 跨 vault 链接需要加前缀，比如
![[vault2.foo.bar]]，前提是vault2已在dendron.yml中正确定义并启用 - 预览不渲染链接？先确认 VSCode 右上角的「Preview」按钮是否点成了「Markdown Preview」——Dendron 自带的预览器叫
Dendron Preview，图标是蓝色方块，不是 VSCode 原生那个 - 链接高亮失效常见于开启
enableWorkspaceTrust后未信任工作区，此时需点击左下角锁形图标手动标记为“受信任”
同步到 GitHub 时 docs/ 下的笔记总被忽略
docs/ 是 Dendron 默认内容目录，但它本身不在 .gitignore 里——真正被忽略的是生成物，比如 docs/.next/ 或 public/，而你的源笔记（.md 文件）必须显式提交。
- 检查
.gitignore是否误加了docs/**或*.md，Dendron 初始化生成的 ignore 文件默认只排除构建产物 - 运行
git status --ignored看哪些文件被忽略了，常见陷阱是把整个docs/加进了 ignore，或用了 VSCode 的「文件 → 忽略」右键菜单，它会偷偷往.gitignore写规则 - 如果用
dendron publish构建静态站，注意public/是输出目录，不应提交；但docs/下所有.md必须提交，否则协作时别人 clone 下来就是空 vault
最常被跳过的其实是初始化后的第一次 git add . ——很多人以为装完插件点几下就完了，结果 dendron.yml 和 docs/ 根本没进版本控制，后续所有操作都在本地裸跑。真要长期用，初始化那一步的手动 git init && git add . && git commit -m "init dendron" 不能省。
