Windows系统使用命令生成文件夹下项目目录树（文件结构树）的两种高效方法

前言：

有时候我使用ai的时候需要提供一下当前目录下的文件树，或者我在写readme.md文件的时候需要提供一下当前目录下的文件树，就可以使用下述方法。（适用于windows系统）

方法一：tree 命令 —— 快速生成经典目录树

tree 是 Windows CMD 内置的经典工具，可以快速生成直观的、人类可读的目录结构。

操作步骤：

1. 在项目文件夹的地址栏输入 cmd 并回车，直接启动命令提示符。
2. 运行以下命令：

   tree /f /a > structure.txt
   

   • /f：显示每个文件夹中的文件名。
   • /a：使用 ASCII 字符，确保在任何平台粘贴都不会出现乱码。

默认输出示例：

D:.
|   README.md
|   package.json
|
\---src|   index.js\---componentsButton.js

要点解读：
输出中的 D:. 代表“当前目录”。这是 tree 的标准行为，AI 完全可以理解。当你在某个目录下执行该命令时，. 就代表“当前工作目录”。所以 D:. 意为“位于D盘上的当前目录”。

可选技巧：显示完整根路径

如果你希望输出的根节点直接显示项目文件夹名，而不是 .，可以从其父目录执行 tree 命令。

1. 首先进入项目的上一级目录。例如，如果项目在 D:\coding\my-project，则先进入 D:\coding。
2. 然后将项目文件夹名作为参数传给 tree：

   tree "my-project" /f /a > "my-project\structure.txt"
   

输出示例：

这种方式生成的树状图直接以项目文件夹的完整路径作为根节点。

D:\CODING\MY-PROJECT
|   README.md
|   package.json
|
\---src|   index.js\---componentsButton.js

注意，根节点现在是清晰的 D:\CODING\MY-PROJECT，而不是 D:.。这种方法在视觉上更加明确。

方法二：PowerShell —— 可以精准过滤“降噪”的命令

当项目包含 node_modules、编译产物（如.log, .aux）或虚拟环境时，tree 的输出会过于臃肿。PowerShell 提供了强大的过滤能力，可以生成一份干净降噪的文件列表。

操作步骤：

1. 在项目文件夹空白处右键 -> 在终端中打开（推荐方式）。

2. 运行以下优化后的命令：

   # 针对通用项目，可按需修改 -Exclude 列表
   Get-ChildItem -Recurse -Exclude "node_modules", ".git", "dist", "*.log" | Where-Object { !$_.PSIsContainer } | Resolve-Path -Relative | Sort-Object | Out-File clean_structure.txt
   

命令拆解：

• Get-ChildItem -Recurse: 递归扫描所有文件和文件夹。
• -Exclude "...": 核心过滤。按需排除不需要的目录和文件（如"node_modules", ".git", __pycache__ 等）。
• Where-Object { !$_.PSIsContainer }: 只保留文件，剔除空目录的显示。
• Resolve-Path -Relative: 将文件的绝对长路径转换为简洁的相对路径，极大减少了文本量，节省 Token。
• Sort-Object: 对结果排序，使其更清晰。
• Out-File ...: 将最终的干净列表保存到文件。

示例输出（相对路径列表）：

README.md
package.json
src/index.js
src/components/Button.js

这份列表非常精炼，只包含项目的核心逻辑文件。

总结与建议

• tree 命令：简单、快速、直观。适用于小型、干净的项目，或需要快速了解和展示结构。
• PowerShell 方法：功能强大、可定制。是处理任何中大型、复杂项目的首选。通过精准过滤和路径转换，能生成过滤后相对干净友好的文件结构。