臭鼠标写技术文档、项目说明或是整理 README 的时候，遇到“目录树”这一段，估计不少人会卡住。想在文档里展示项目结构，键盘上却找不到带拐角的画线键，于是只能退而求其次，用 |---、|-- 甚至一堆 -> 凑合。这样写出来的树，乍一看还行，细看横线断裂、竖线不齐，复制到别的编辑器里更是直接错位。这篇文章专门解决这个问题：在 Windows 操作系统里，怎么正确输入“├──”和“└──”这组符号，并且顺手把完整的目录树生成出来。不管你是写 README、技术方案，还是临时要给同事讲清一个文件夹的层次，这些方法都能直接抄。
1. 这组字符到底解决了什么问题：文件结构图的原始需求
1.1 纯文本环境里，树形字符几乎是唯一选择
图形界面里想展示目录，直接截个图最省事。但技术文档、代码仓库说明、社区帖子、群消息这些场景，更多是纯文本或半纯文本的，必须用字符画出层级关系。ASCII 字符集里没有专门的画线符号，早期大家用 |、-、+ 硬拼，典型的就是 Windows tree /A 的输出：
code复制project
|-- src
| |-- main.py
| `-- utils
| `-- helper.py
`-- tests
`-- test_main.py
这种 ASCII 方案兼容性最好，但视觉上偏挤，层级一旦超过两三层，眼睛分辨起来就费劲。Unicode 里专门有一个“制表符/方框绘制”区段，就是为干这个设计的。├ 表示“这里还有同级条目继续往后排”，└ 表示“从此处往下没有同级兄弟了”，配合 ── 横向连线和 │ 纵向贯穿线，可以精确表达任意层级的父子关系。这套符号不是某个软件的私有字符，而是国际标准字符集里的通用“积木”，所以只要字库支持、编码正确，放到任何平台都能看。
1.2 同样的树，两种写法的观感完全不在一个量级
我用同一个项目结构对比一下。先看 ASCII 替代方案：
code复制project
|-- src
| |-- main.py
| `-- utils
| `-- helper.py
`-- tests
`-- test_main.py
再看标准框线字符方案：
code复制project
├── src
│ ├── main.py
│ └── utils
│ └── helper.py
└── tests
└── test_main.py
区别一眼能看出来：标准框线字符连接顺畅，层级该断的断、该连的连，整体更像一张图；ASCII 方案虽然也能看懂，但 |-- 和 `-- 混在一堆，眼睛得多花两秒做“解析”。在 GitHub 代码块、语雀文档、飞书文档、公众号文章里，标准框线字符的展示效果都要好一个档次。
1.3 除了目录树，还能用在哪些地方
这个 H3 想说明一点：├── 和 └── 不只是文件结构专用。流程分支、菜单层级、思维导图的文本导出、接口包结构说明，甚至表格里表达数据的父子归属，都能用到。本质上，它解决的是“在没有图形界面的前提下，用文本精确表达层次关系”的通用需求。文件结构只是最常见也最典型的一种应用。所以学会这组字符的使用规则，是受用很久的技能。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 先认清字符本身：码位、名称、相似字符
2.1 这些符号的 Unicode 身份卡片
很多人只知道“这是个符号”，但不知道怎么描述它、怎么查找它，更不知道用 Alt 输入时该敲哪个数字。我整理了一张身份卡片：
| 字符 | Unicode 名称 | 码位 | UTF-8 编码 | 十进制码（Alt 输入用） |
|---|---|---|---|---|
| ├ | BOX DRAWINGS LIGHT VERTICAL AND RIGHT | U+251C | E2 94 9C | 9500 |
| └ | BOX DRAWINGS LIGHT UP AND RIGHT | U+2514 | E2 94 94 | 9504 |
| ─ | BOX DRAWINGS LIGHT HORIZONTAL | U+2500 | E2 94 80 | 9472 |
| │ | BOX DRAWINGS LIGHT VERTICAL | U+2502 | E2 94 82 | 9474 |
| ┌ | BOX DRAWINGS LIGHT DOWN AND RIGHT | U+250C | E2 94 8C | 9484 |
| ┐ | BOX DRAWINGS LIGHT DOWN AND LEFT | U+2510 | E2 94 90 | 9488 |
| ┘ | BOX DRAWINGS LIGHT UP AND LEFT | U+2518 | E2 94 98 | 9496 |
这几个字符属于“制表符（Box Drawing）”区段，字体一般把它们按半角宽度渲染。├ 和 └ 是最常用的两个“转角”，─ 是横向连接线，│ 是纵向贯穿线。理解了对应关系，用工具查找时就不至于翻半天找不到。
2.2 为什么看起来一样，其实根本不是同一个字符
画目录树最常见的翻车，就是把 ASCII 连字符当成框线横线用。-（U+002D）、|（U+007C）、_（U+005F）和 ─（U+2500）、│（U+2502）完全是两回事。等宽字体里，ASCII 连字符中间通常留白，多个连在一起会有断开感；而 ─ 是连续画线字元，两个字符拼起来就是一条光滑实线。同理，│ 和竖线 | 粗细也不同，混用会导致树形连接处对不齐、粗细不一。能分辨这一点，后面排查“横线断裂”“竖线不齐”这类问题能省很多时间。
2.3 字体支持：为什么有时候会出现“豆腐块”
Windows 自带的 Consolas、微软雅黑、宋体、新宋体、Courier New 基本都包含这些框线符号，VS Code 默认字体、Windows Terminal 默认的 Cascadia Code 也完整支持。如果你在某个老软件、老终端或者某些在线编辑器里看到方块或空白，大概率是字体不支持，换成上述字体就能解决。这条经验可以提前记着，免得真遇到时还以为是自己输入错了。
3. Windows 手工输入这组符号的六种姿势
3.1 字符映射表：最基础但绝对有效
字符映射表是 Windows 自带组件，不依赖输入法，任何版本都能用。
操作步骤：
- 按
Win + R，输入charmap，回车。 - 顶部字体选择“宋体”或“Consolas”。为了避免来回翻找，勾选底部的“高级检查”，把“字符集”切到 Unicode，然后在搜索框里输入“251C”，就能直接定位到
├。 - 点“选择”再点“复制”，到目标位置粘贴。
- 同样方式搜索
2514复制└，搜索2500复制─，搜索2502复制│。
这个方法适合偶尔用一次的用户，缺点是逐字查找复制比较慢。不过它非常稳定，不会受输入法状态和键盘布局影响。
3.2 Alt + 小键盘：老牌快捷键，但有限制
如果你的键盘有独立数字小键盘，并且 Num Lock 处于开启状态，可以用 Alt 码快速输入：
├：按住 Alt，小键盘输入9500，松开└：按住 Alt，小键盘输入9504，松开─：按住 Alt，小键盘输入9472，松开│：按住 Alt，小键盘输入9474，松开
注意两个坑：第一，输入法要切到英文模式或半角状态，否则 Alt+数字可能被输入法当成候选词翻页功能；第二，笔记本没有独立小键盘时，这个方法基本不可用，建议用下一招。
3.3 输入法符号面板：中英文环境下都好用
以搜狗拼音为例，按 Ctrl+Shift+Z 打开符号大全，切到“特殊符号”或“制表符”分类，就能看到 ├、└、│、─。微软拼音可以在输入法状态栏上找小键盘图标，点开后选“特殊符号”或“制表符”，弹出面板后逐字选取。其他中文输入法也大同小异。
这个方法的好处是不用从编辑器里切出去，输入效率比字符映射表高，而且可以在字符面板里反复选取，适合一次性画一棵小树。
3.4 Win + 分号打开系统符号面板：没想到它也能干这活
Windows 10/11 按 Win + ; 或 Win + . 会弹出表情符号和特殊字符面板。切到“符号”选项卡，往下翻能找到“制表符”或“方框绘制”分类，里面就有 ├、└、─、│。这个面板在任何系统级文本框里都能呼出，不依赖第三方输入法，属于“藏得比较深但很管用”的方案。你甚至可以在这个面板的搜索框里敲“制表”试着搜索，不过不同版本的支持程度不一样，翻分类更稳。
3.5 自定义短语与文本替换：高频输入者的终极解法
如果你一周要画好几棵目录树，每次开符号面板还是太慢。建议在输入法里设置自定义短语。搜狗输入法在“属性设置-词库-自定义短语”里添加，比如把 # 定义为 ├── ，把 %% 定义为 └── ，之后输入对应字母就能直接上屏。微软拼音、QQ输入法也有类似功能，只是不同版本入口不一，按自己输入法的实际界面找一下。
更进阶的做法是用 AutoHotkey 做文本替换：
autohotkey复制::ltree::├──
::rtree::└──
::vline::│
::hline::─
保存为 .ahk 脚本运行时，你只要输入 ltree 按空格，就会自动变成 ├──。这套思路特别适合“我记不住码位、不想翻面板”的人，写完一次脚本，以后所有软件里都能用。
3.6 复制粘贴大法：最不折腾，但要有“字符弹药库”
如果只是临时用一次，从本文、从任何代码块里直接复制 ├──、└──、│ 到目标位置，然后改后面的文件名就行。别小看这个办法，实际场景里“复制一次，微调十次”是最常见流程。我一般会在云笔记里存一个小页面，专门放这些字符，手机上、电脑上都能随时打开复制。你也可以建一个 tree-chars.txt，里面存好前缀组合，需要时打开复制。
4. 让工具替你画树：目录树自动生成方案
4.1 Windows 自带 tree 命令：简单直接
不用装任何软件，在 CMD 或 PowerShell 里切到目标目录，执行：
code复制tree /F
/F 表示连文件一起列出来，不加这个参数只列目录。输出是标准框线字符，只是横线有三根：
code复制D:.
├───.git
├───README.md
├───src
│ ├───main.py
│ └───utils
│ ├───config.py
│ └───logger.py
└───tests
└───test_main.py
如果想让输出在老旧系统里也能兼容显示，可以加 /A 强行用 ASCII 字符。注意 Windows tree 的横线是三个 ───，而很多文档习惯写两个 ──，两种风格都有人用，关键是整棵树保持一致。你可以在生成后对连接线做一次全文替换，把 ─── 换成 ──，视觉上更紧凑。
4.2 在 Git Bash 或 WSL 里用 Linux 的 tree：功能更强
Windows 自带的 tree 有个硬伤：没法排除目录。你想忽略 .git、node_modules、__pycache__ 这些噪音目录，它做不到。如果电脑上装了 WSL 或者 Git for Windows 提供的类 Unix 环境，可以用 Linux 的 tree。
code复制tree -L 3 -I "node_modules|.git|__pycache__"
-L 控制递归深度，-I 指定排除规则，-a 显示隐藏文件。输出格式正是 ├──、└──、│，复制到文档里即可。WSL 里一般自带 tree，如果没有，用 apt install tree 装一下。这个方案是我在工作中最常用的，因为过滤能力强，目录一多就知道有多香了。
4.3 用 Python 脚本生成目录树：灵活可控
如果你需要调整排序规则、给目录名加后缀、或者按你的业务逻辑定制输出格式，脚本是最灵活的。下面这段脚本是我经常改着用的基础版：
python复制import os
def generate_tree(path, prefix="", exclude=("node_modules", ".git", "__pycache__")):
try:
entries = [e for e in os.listdir(path) if e not in exclude]
except PermissionError:
return
dirs = [e for e in entries if os.path.isdir(os.path.join(path, e))]
files = [e for e in entries if os.path.isfile(os.path.join(path, e))]
all_entries = dirs + files
for i, entry in enumerate(all_entries):
is_last = i == len(all_entries) - 1
connector = "└── " if is_last else "├── "
print(prefix + connector + entry)
child_path = os.path.join(path, entry)
if os.path.isdir(child_path):
extension = " " if is_last else "│ "
generate_tree(child_path, prefix + extension, exclude)
if __name__ == "__main__":
import sys
root = sys.argv[1] if len(sys.argv) > 1 else "."
generate_tree(root)
保存为 tree.py，在终端执行：
code复制python tree.py .
脚本把目录排在文件前面，排除列表可以随时改。相比系统命令，它的优势是“可定制”：比如你可以把 node_modules 换成别的目录，也可以让目录名后面统一带 /，方便读者一眼分辨目录和文件。
4.4 VS Code 插件和在线工具
如果不想碰命令行，VS Code 扩展市场里搜 tree generator、project tree 这类关键词，会有好几款能一键生成目录树并插入 Markdown 的插件。在线目录树生成器也值得收藏，你粘贴一段文件清单，它给你生成带 ├──、└── 的树形文本，适合临时用。我个人对第三方插件的依赖比较低，因为命令行方案已经足够快，但插件对不熟悉终端的人确实友好得多。
5. 乱码、对齐和字体：三件容易翻车的事
5.1 从终端复制到文档乱码，先检查编码
最常见的一幕：在 CMD 里执行 tree，复制输出，粘贴到 VS Code 里，结果变成 鈹€ 鈹€ 鈹€ 这种奇怪字符。原因是中文 Windows 的 CMD 默认代码页是 GBK/CP936，框线字符按 GBK 字节存储，复制到 UTF-8 文档里，编辑器用自己的编码去解读，自然乱掉。
解决办法很简单：先执行一次 chcp 65001 把控制台切成 UTF-8，再运行 tree；或者干脆不要直接复制，而是执行 tree /F > tree.txt 把输出写到文件，再用 VS Code 打开并改成 UTF-8 保存。更省心的方式是直接在 VS Code 的集成终端里跑命令，终端和编辑器共享同一套编码体系，乱码概率低很多。
5.2 横线断断续续，多半是混用了 ASCII 连字符
看到树形图中横线一段一段、中间透出空白，十有八九是文章中混用了 - 和 ─。有些人从网上复制示例时，复制到一半符号被系统“降级”成了 ASCII 连字符，后面又没有发现问题。修复办法就是全文统一替换：把所有 ├---、├-- 里的连字符统一改成 ─，让 ├ 后面跟两个或三个标准框线横线。
5.3 字体不显示，变成“豆腐块”
在 Word、WPS 或某些老编辑器里，如果字符显示成空心方框，就是当前字体不包含这些框线字形。解决办法是选中这些字符，把字体改成“宋体”“微软雅黑”或“Consolas”。在 Windows Terminal 里遇到这个问题，去设置里把终端字体改成 Cascadia Code 或 Consolas。多数情况这不是字符输入错误，而是渲染字体不对。
5.4 Markdown 渲染差异：如果不放在代码块里，结构会垮
Markdown 里展示目录树，必须把整棵树放进代码块，即用三个反引号包起来。否则某些渲染器会把多个 - 或连续线解析成表格分隔线、删除线，导致结构散架。放进代码块就等于告诉渲染器“这一段是纯文本，别做任何特殊处理”，这是最稳妥的做法。
5.5 对齐规则：半角空格一错，整棵树就歪
画树时，每一层的缩进前缀是固定的：要么是 │ （半角竖线加三个半角空格），要么是 （四个半角空格）。很多人下意识用 Tab 或全角空格去对齐，结果在等宽字体里整个错位。这里给个判断规律：├── 后面跟一个空格接文件名；下一层的前缀要用父级的前缀再拼接一层 │ 或 ；最后一条分支用 └──，它的子级前缀以四个空格开头。只要每层都遵循这个规则，在任何等宽字体里都能对齐。
6. 一个可直接套用的 README 目录树模板
6.1 从真实项目快速生成到 README
我平时整理一个开源项目的 README，操作路径基本固定：在 WSL 或 Git Bash 里执行 tree 命令，排除掉不想展示的目录，然后把输出贴进 Markdown 代码块，最后根据 README 的叙述重点微调顺序。比如某个 Python 项目，我会这样操作：
code复制tree -L 2 -I "node_modules|.git|__pycache__|.idea"
最终效果：
code复制myproject/
├── README.md
├── requirements.txt
├── src/
│ ├── __init__.py
│ ├── main.py
│ └── utils/
│ ├── __init__.py
│ ├── logger.py
│ └── config.py
├── tests/
│ └── test_main.py
└── docs/
└── architecture.md
这个树既展示了核心代码位置，又没被噪音目录塞满。
6.2 手动画树时，先记住这套“规则速查”
如果临时只有三五条，不想开任何工具，记住这个口诀就够了：
| 符号 | 含义 |
|---|---|
├── |
同级还有后续条目，当前项按分支引出 |
└── |
当前条目是此分支的最后一项 |
│ |
父级竖线延续，用于下一级前缀 |