直接用Node.js脚本生成树状图最可控，不依赖插件、不卡顿、可定制过滤和格式；因其同步递归+显式过滤+深度控制，避免异步嵌套与内存溢出，且能注入Markdown或集成构建流程，而插件常因监听延迟、符号链接未解析及files.exclude误用导致漏目录或缩进错乱。
直接用 Node.js 脚本生成树状图最可控，不依赖插件、不卡顿、可定制过滤和格式——但必须自己写或复用可靠脚本，VSCode 本身不提供“一键 Node 树生成”功能。
为什么不用 VSCode 插件生成树状图
像 project-tree 或 file-tree-generator 这类插件常因文件监听延迟、符号链接未解析、files.exclude 配置误用，导致输出漏目录（比如 pnpm workspace 中的 symlinked package）或缩进错乱。更关键的是：插件默认按编辑器 UI 显示逻辑过滤，而项目结构文档需要反映真实磁盘结构，二者目标不一致。
Node 脚本怎么写才不崩、不卡、不漏
核心是同步递归 + 显式过滤 + 深度控制，避免 fs.readdir 异步嵌套地狱和内存溢出。以下要点必须落实：
- 用
fs.readdirSync而非fs.promises.readdir，防止深度嵌套时 event loop 堵塞（尤其含千级文件的node_modules） -
IGNORE_PATTERNS必须包含node_modules、.git、dist、build、.vscode、.DS_Store——漏一个就可能输出上万行 - 加深度限制，例如在递归函数里传入
depth参数，到3就停，否则遇到深层嵌套日志目录会卡死 - 文件/文件夹分开处理，用
?和?标识，比纯 ASCII 更易读；但若用于 CI 文档，建议去掉 emoji，改用/和空后缀统一风格
如何在 VSCode 终端里真正“一键”运行
所谓一键，本质是把脚本固化为可快速触发的操作，而非每次输 node xxx.js：
- 把脚本存为
gen-tree.js放项目根目录，内容含process.argv[2]接收路径参数（如node gen-tree.js ./src） - 在 VSCode 终端中执行一次后，按
↑调出历史命令，回车即重跑——这是最快路径，无需配置 - 想更稳一点：在
.vscode/tasks.json里定义 task，command 设为node gen-tree.js，args 设为["."]，然后Ctrl+Shift+P→Tasks: Run Task选它 - 别用
npm script包一层再调，除非你真需要跨平台兼容（Windows 上 npm run 的 shell 环境有时会吞掉某些字符）
tree 命令和 Node 脚本选哪个
如果你系统已装 tree（macOS brew install tree，Windows 推荐 WSL 或 choco install tree），优先用它——输出稳定、性能碾压 Node 脚本，且 tree -I "node_modules|.git" 参数成熟无坑。Node 脚本唯一不可替代的场景是：你需要把树结构注入 Markdown 自动更新 README，或集成进构建流程做校验。这时候才值得写、才值得维护。
