project tree 插件将项目文件树渲染为带emoji图标的markdown文本并追加至readme.md底部,不创建实际文件;directory tree更轻量、支持glob过滤且用ascii符号兼容性更好;markdown all in one仅生成文档内toc,与文件系统无关;真实目录创建需脚本或代码实现。

Project Tree 插件生成目录结构到 README.md
Project Tree 不是生成“可执行的目录”,而是把当前项目文件树渲染成带图标和缩进的 Markdown 文本,直接追加到 README.md 底部。它不创建任何文件或目录,只做可视化输出。
- 安装插件后,按
Ctrl+Shift+P输入Project Tree,回车即可触发 - 如果项目没有
README.md,插件会自动创建一个空文件再写入内容 - 生成结果含 emoji 图标(如 ? 表示目录、? 表示文件),但这些符号在某些终端或 CI 环境里可能显示异常或被过滤
- 输出默认包含隐藏文件(如
.git、.vscode),若想排除,需手动删减或改用其他插件
Directory Tree 插件更轻量、支持自定义过滤
Directory Tree 和 Project Tree 功能相似,但配置更透明:它提供 directoryTree.exclude 设置项,可填 glob 模式精确屏蔽不需要的路径。
- 常见排除项示例:
["**/node_modules/**", "**/.git/**", "**/dist/**"] - 生成位置同样是
README.md,但不会自动创建该文件——若不存在,操作会失败并提示 - 不依赖 emoji,纯 ASCII 符号(
├─、└─)兼容性更好,适合需要 CI 自动解析 README 的场景 - 右键菜单里有 “Generate Directory Tree” 选项,比命令面板更快捷
Markdown All in One 生成的是文档内 TOC,不是项目结构
很多人混淆了“项目目录索引”和“Markdown 文档目录(TOC)”。Markdown All in One 的 Create Table of Contents 命令只扫描当前 .md 文件里的 #~###### 标题,跟磁盘上的文件树完全无关。
- 它生成的是跳转链接列表,例如
- [安装步骤](#安装步骤),仅对文档内部有效 - 如果你在
README.md里写了大量章节说明,这个功能才有意义;单纯想看 src/ 下有几个 .ts 文件,它帮不上忙 - 中文标题会被转成 URL-safe 锚点(如
快速开始→#%E5%BF%AB%E9%80%9F%E5%BC%80%E5%A7%8B),部分旧版 GitLab 或静态站点生成器可能解析失败
真正要“构建目录”,得靠脚本或代码片段
VSCode 所有插件都只能“展示”或“描述”目录,不能替你 mkdir -p 或 touch 创建真实文件。真要初始化项目结构,必须脱离 GUI,走自动化路径。
- 最简方案:用 VSCode 自定义
user snippets,定义前缀如proj-vue,展开后是预设的src/、public/、package.json等文本块,粘贴后手动保存为对应路径 - 可靠方案:写一个
create-project.sh,用mkdir -p和touch组合建目录+空文件,再通过tasks.json集成进 VSCode,Ctrl+Shift+B就能跑 - 注意点:脚本里路径别硬编码绝对路径,用
$1接项目名,配合cd "$(dirname "$0")/.."确保相对路径行为一致
真正容易被忽略的是:目录索引 ≠ 目录创建。看到插件输出了一堆 ├─ src/ 并不意味着 src/ 文件夹已经存在——它只是字符串。需要哪一层真实落地,就得明确告诉系统去执行,而不是依赖“看起来像”。











