project manager插件添加项目失败需检查rootpath是否为合法绝对路径（末尾无斜杠）及目录是否含.vscode/settings.json等标志性文件；纯空目录或仅readme.md会被跳过，须手动右键添加。
Project Manager 插件添加项目总失败？检查 rootPath 和标志性文件
Project Manager 不会自动扫描文件夹，它只认你手动加进去的路径，而且不是所有文件夹都能被识别为“项目”。rootPath 必须是绝对路径、末尾不能带斜杠，比如 /home/user/my-project 合法，/home/user/my-project/ 就会导致打开失败。
插件默认靠是否存在 .vscode/settings.json、package.json、pyproject.toml 等文件来判断一个目录是不是“项目”。纯空目录或只有 README.md 的目录会被跳过。
- 右键资源管理器里目标文件夹 → 选
Add Folder to Project Manager - 别用
~/或环境变量缩写，必须写完整绝对路径 - 如果项目结构统一（如全在
~/src/下），可提前生成projects.json再替换插件配置文件
目录树插件 directory-tree 生成的结构乱码或不完整？注意编码和隐藏文件过滤
directory-tree 默认会忽略 .git、node_modules 等常见目录，但不会自动处理中文路径或非 UTF-8 编码的文件系统。如果你看到目录项显示为 或层级错位，大概率是终端渲染或 VSCode 文件系统层的编码问题。
该插件生成的树状结构直接写入 README.md 底部，不依赖预览插件，但也不支持自定义图标或折叠逻辑——它只是静态快照。
- 确保项目根目录所在磁盘/挂载点使用 UTF-8 编码（Linux/macOS 通常默认，Windows WSL 需确认 locale）
- 若想排除特定目录（如
dist），需在插件设置里修改directoryTree.ignoredFolders，不是靠文件名前缀 - 生成后不要手动删改树状文本里的缩进或符号，否则下次更新会覆盖错位
Markdown All in One 的 TOC 不跳转？锚点生成规则和空格处理是关键
VSCode 原生 Markdown 预览不支持点击目录跳转到标题，必须靠插件生成带链接的 TOC 块。而 Markdown All in One 生成的锚点（即 [简介](#简介) 中的 #简介）是按标题文本自动转义的：空格变 -，中文直接保留，标点被移除。
比如标题 ## API 调用说明（含错误码） 对应的锚点是 #api-调用说明含错误码，不是 #api-调用说明 或带括号的版本。
- 避免在标题里用
!、?、&等 URL 不安全字符，它们会被静默剔除 - 同一文档中出现重复标题（哪怕大小写不同），后生成的锚点会覆盖前一个，导致跳转错乱
- 修改标题后必须重新运行
Markdown: Create Table of Contents，它不会自动监听变更
多个插件共存时命令冲突？优先级和快捷键绑定要手动理清
当你同时装了 Project Manager、directory-tree 和 Markdown All in One，它们的命令都注册在全局命令面板里，但快捷键可能重叠或未设默认值。例如 Ctrl+Shift+P 后输入 “Update TOC” 可能匹配到两个插件的命令，实际执行哪个取决于 VSCode 加载顺序。
VSCode 不提供插件命令优先级开关，只能靠用户手动绑定或禁用冗余项。
- 在设置里搜
keybindings，过滤出含 “toc”、“project”、“tree” 的条目，删掉不用的快捷键绑定 -
Project Manager的Open Project in New Window (Force)比普通Open Project更可靠，尤其在多窗口策略开启时 - 如果某插件命令突然消失，先运行
Developer: Toggle Developer Tools查控制台是否有Cannot find command报错，常因插件未激活或版本不兼容
真实项目里往往不是单点配置能搞定的事——projects.json 路径失效、directory-tree 遇到符号链接、TOC 锚点在某些 Markdown 渲染器里不生效……这些细节不爆一次错很难记住。
