结论错误：tree命令才是唯一可信的项目结构导出方式，因其直接读取磁盘、不依赖VSCode配置，在pnpm workspace、Lerna或符号链接场景下准确可靠；Project Tree等插件因依赖files.exclude配置、忽略符号链接、默认不递归扫描未打开文件夹，输出不可信。
直接说结论：用 Project Tree 插件生成项目结构最轻量、最可控，不需要额外命令行或脚本，也不依赖 Node.js 环境；但它的输出默认只写入 README.md，且不支持过滤隐藏文件或自定义缩进——这些细节恰恰是专业导出时最容易翻车的地方。
为什么不用 tree 命令？
很多人第一反应是终端里跑 tree -I "node_modules|.git|dist"，确实能快速输出。但它有三个硬伤：
- Windows 默认没装
tree，得额外装 Git Bash 或 WSL 才能用 - 输出格式固定（ASCII 树形），没法直接转成 Markdown 列表或嵌套代码块
- 无法和 VSCode 编辑器联动——比如选中某个子目录再生成局部结构
如果你的文档要嵌入 README 或技术博客，tree 的原始输出还得手动清洗、缩进对齐、加链接，反而拖慢流程。
Project Tree 插件怎么避免覆盖已有内容？
它默认会清空整个 README.md，只保留生成的结构——这对已有文档简直是灾难。解决办法很简单：
- 在
README.md里用 HTML 注释标记插入点：<!-- PROJECT_TREE_START -->和<!-- PROJECT_TREE_END --> - 插件设置里启用
projectTree.useCustomMarkers，并填入这两个字符串 - 这样每次执行命令，只会替换两段注释之间的内容，其余部分原封不动
注意：这个功能默认关闭，必须手动开启，否则你改十次 README 都会白忙。
需要导出为 JSON 或供 LLM 解析怎么办？
Project Tree 不支持 JSON 输出，但你可以用 file-tree-generator 插件替代：
- 安装后按
Ctrl+Shift+P，运行File Tree Generator: Generate File Tree - 它支持输出格式切换：
markdown、json、plain，甚至可选是否包含文件大小 - 关键参数
fileTreeGenerator.excludePatterns能填正则，比如"^\.vscode$|^\.git$"，比tree -I更精准
不过它不自动写入文件，而是弹出新编辑器标签页——你要手动 Ctrl+S 保存，这点容易漏。
真正麻烦的不是生成结构，而是“哪些该留、哪些该藏”。比如 .env.example 要展示，.env 必须过滤；package-lock.json 通常不进文档，但 CI 流程可能需要它出现在结构里。这些规则没法靠一个插件全包，得靠你提前想清楚边界。
