vscode插件生成目录树不可靠，因其依赖文件监听而非直读文件系统：symlink被误处理、受files.exclude影响、路径含file://或转义错误、不识别真实工作目录；真正可靠的是tree命令等文件系统直读工具。
VSCode插件能快速生成目录树，但不可信——尤其当你要交付文档、做 CI 集成或排查 symlink 问题时。
Project Tree 和 directory-tree 插件输出常和磁盘实际结构不一致
这两款插件默认走 VSCode 的文件监听机制，不是直接读取文件系统。这意味着：
- 符号链接（symlink）可能被忽略或展开为真实路径，而
tree命令默认只显示链接本身 - 如果项目用了 pnpm workspace 或 Lerna，插件常把 packages/ 下的软链包当成普通文件夹，导致层级错乱
-
files.exclude和search.exclude配置会被自动应用，比如你排除了dist/，插件就真不显示它——哪怕你正需要在架构图里标出构建产物位置 - Windows 上遇到长路径或权限受限目录（如某些 node_modules 子目录），插件可能静默跳过，不报错也不提示
File Tree Generator 类插件导出 Markdown 后链接失效
这类插件生成的路径默认带本地文件协议（file:///）或相对路径错误，粘贴到 GitHub、Notion、飞书等平台后点击即 404：
- 右键生成时选 “Markdown” 格式，路径常是
./src/components/Button.vue，但 GitHub 只认src/components/Button.vue（去点） - 根目录名会被硬编码进路径，例如
my-project/src/...，一旦重命名项目就全挂 - 部分插件会把空格、括号转义成
%20或[，导致链接无法解析 - 若想修复，得手动全局替换：
.\<root></root>→，再把所有\换成/，但每次更新都要重来
用插件前必须确认当前工作目录是否为项目根目录
很多用户右键“在终端中打开”，却没注意终端 pwd 是 /home/user 而非 /home/user/my-app，结果插件调用的 tree 或内部命令扫错地方：
- 插件内部若调用系统
tree，它只认当前 shell 工作目录，不会自动向上找package.json或.git - VSCode 的“资源管理器”高亮目录 ≠ 终端当前路径，二者完全独立
- 验证方式：在 VSCode 内置终端执行
pwd，再对比左侧资源管理器顶部显示的路径 - 安全做法：先
cd到目标目录，再触发插件命令；或在插件设置里指定rootPath（少数插件支持）
真正可靠的目录树永远来自文件系统直读——tree 命令或 find + sed 组合。插件只适合临时预览、个人笔记草稿，别让它出现在 README 自动化流程或交接文档里。
