directory-tree插件仅将现有项目结构转为带emoji的树状文本并追加至README.md,不创建文件;默认跳过node_modules等,但不识别.gitignore自定义项,需手动配置exclude数组。

用 directory-tree 插件生成项目结构快照
directory-tree 插件不是用来“创建”目录,而是把当前已有项目结构转成可读的树状文本,常用于写 README 或交接文档。它不新建任何文件或文件夹,只读取现有磁盘内容并格式化输出。
安装后按 Ctrl+Shift+P 输入 Directory Tree: Generate 回车,插件会自动在项目根目录的 README.md 底部追加结构(若无该文件则新建)。注意:它默认跳过 node_modules、.git 等常见忽略项,但不会识别 .gitignore 里的自定义条目——想排除某目录得手动改插件设置里的 exclude 数组。
- 输出带 emoji 图标(如 ? 表示文件夹),GitHub 渲染正常,但某些 CI 工具可能报 warning
- 生成结果是纯文本,不能直接执行创建操作;想反向还原结构需配合脚本解析
- 如果项目刚初始化、几乎为空,生成结果会很短,容易误以为插件没生效
用 Project Tree 插件导出结构并编辑再创建
Project Tree 和 directory-tree 功能接近,但它支持“编辑后回写”:生成结构文本后,你可以手动增删行、调整缩进,然后右键选择 Generate files from project tree,它会按你改过的文本实际创建缺失的目录和空文件。
这个流程适合从模板起步——比如先复制一份标准 React 结构文本,删掉不需要的子目录(如 cypress),再生成。但要注意:
- 只创建不存在的路径,已存在的文件/目录会被跳过,不会覆盖或清空
- 文件名带空格或特殊字符(如
my config.ts)会导致创建失败,建议用下划线或短横线 - 缩进必须用空格(不能用 Tab),且每级缩进为 2 或 4 个空格,混用会解析错层
用 File Utils 扩展直接批量新建文件和文件夹
File Utils 提供命令面板入口 File Utils: Create Files and Folders,支持一次性输入多行路径,自动补全父目录。例如输入:
src/components/Button.vue src/utils/request.ts public/favicon.ico
它会逐行检查,先建 src,再建 src/components,最后创建三个空文件。比手动右键快得多,也比写 shell 脚本轻量。
但有几个硬限制:
- 不支持通配符或变量(如不能写
src/pages/*.vue) - 所有路径基于当前打开的文件夹(即工作区根目录),无法跨工作区操作
- 创建失败时只提示“Error”,不说明哪一行出错,建议一次别输太多行
为什么不用脚手架就硬写目录结构?
对新项目来说,create-react-app、npm init vue@latest 或 cookiecutter 这类工具生成的结构更可靠——它们内置了版本兼容性判断、依赖注入、配置文件校验等逻辑。而手工拼结构容易漏关键文件(比如忘了 tsconfig.json 或 .eslintrc.cjs),导致后续开发卡在环境配置上。
真正需要手动建目录的场景其实很窄:比如临时写 demo、给已有项目补子模块、或者定制化极强的内部框架。这时候优先用 File Utils + 终端 mkdir -p 混合操作,比强求“一键全自动”更稳。
最常被忽略的一点:VSCode 的资源管理器里右键新建文件夹时,如果路径含中文或全角符号,部分 Linux/macOS 系统会静默失败,但界面不报错——建议统一用英文命名,确认后再重命名。


















