Ascii Tree插件不提供右键菜单，需通过命令面板调用；默认以工作区根目录为起点生成树结构；支持配置exclude规则过滤目录、useAsciiOnly降级显示及maxDepth调整展开深度。
Ascii Tree插件安装后不显示右键菜单？
插件本身不提供右键菜单入口，这是最常被误解的一点。它只在命令面板中注册了命令，必须手动调用。不要右键找“生成目录树”选项，那根本不存在。
正确做法是：Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）打开命令面板，输入 Ascii Tree: Generate Tree 并回车。
如果命令没出现，说明插件未启用或安装失败。检查扩展面板里 Ascii Tree 是否状态为“已启用”，且没有红色报错提示。
生成的树结构只包含当前文件夹，怎么指定根路径？
插件默认以当前打开的文件夹（即工作区根目录）为起点。如果你在VSCode里打开了一个子文件夹（比如通过“文件 → 将文件夹添加到工作区”），它就会从那个子文件夹开始生成——不是从你当前编辑的文件所在路径。
想换根目录，只有两个办法：
- 关闭当前工作区，重新用“文件 → 打开文件夹”选择目标根目录
- 或者在命令面板运行
Ascii Tree: Generate Tree with Options，它会弹出输入框，允许你手动填入相对路径（如src/）或绝对路径（需以/或C:\开头）
注意：路径必须存在，且不能跨工作区边界；插件不会读取未纳入当前工作区的文件夹。
生成结果里有太多 node_modules、.git 等干扰项？
Ascii Tree 默认不忽略任何文件夹，和 tree 命令一样“裸奔”。要过滤，必须配置 ascii-tree.exclude 设置项。
打开设置（Ctrl+, ），搜索 ascii-tree.exclude，点击“在 settings.json 中编辑”，添加类似内容：
"ascii-tree.exclude": [ "**/node_modules/**", "**/.git/**", "**/dist/**", "**/__pycache__/**" ]
规则语法和 VSCode 的 files.exclude 一致，支持 glob 模式。但注意：它只影响 Ascii Tree 插件自身，不影响其他功能；也不继承 files.exclude 的值，必须显式复制过去。
输出文本缩进错乱或中文显示为方块？
本质是字体和字符宽度问题。Ascii Tree 使用 Unicode 字符（如 ┣, ┃, ┗）绘制树形，这些字符在等宽字体下才对齐。如果你用的是非等宽字体（比如系统默认的微软雅黑），就会错位或显示异常。
解决方法很简单：
- 确保 VSCode 编辑器使用等宽字体：设置里搜
editor.fontFamily，设为"Fira Code", "Consolas", "monospace"这类 - 粘贴生成结果到外部文档时，也得用等宽字体查看（如 Typora 默认用等宽渲染代码块，但 Word 不会）
- 如果仍显示方块，大概率是系统缺少对应 Unicode 区块支持，可尝试改用 ASCII-only 模式：在设置中开启
ascii-tree.useAsciiOnly，它会退化为|,+,-字符组合
真正麻烦的是嵌套过深时自动截断——插件默认只展开 4 层，想看全得手动改 ascii-tree.maxDepth，否则底层文件永远“看不见”。
