Atom默认内置Tree View但可能被禁用，需在Settings→Packages中确认tree-view为Enabled；若未加载项目文件夹、焦点不在侧边栏或快捷键冲突也会导致不显示。
Atom 默认已内置 Tree View，无需额外安装就能显示文件树；但若被禁用、误删或项目未正确加载，就会看不到左侧栏。
Tree View 不显示？先确认是否启用
Atom 从 1.0 版本起就将 tree-view 设为默认包（bundled package），但它可能被手动禁用。打开设置 → Packages → 搜索 tree-view，检查右侧开关是否为「Enabled」。若显示「Disabled」，点击启用即可。
常见误操作包括：
- 在命令面板（
Ctrl+Shift+P）中执行了tree-view:toggle却没成功触发——说明插件根本没加载 - 使用
apm uninstall tree-view彻底删掉了它（不推荐） - 项目没通过
File → Add Project Folder加载，而是直接双击单个文件打开，此时 Tree View 会空着不渲染目录结构
快捷键失效或焦点无法进入？检查当前焦点状态
Tree View 的快捷键（如 a 新建文件、m 移动）只在它获得键盘焦点时生效。若按 Ctrl+\（Windows/Linux）或 Cmd+\（macOS）没反应，可能是：
- 焦点还在编辑器里：先按
Ctrl+0（Windows/Linux）或Cmd+0（macOS）强制聚焦 Tree View - 快捷键被其他插件劫持：比如
vim-mode启用后，a变成插入模式，需先按Esc退出再操作 - 系统级快捷键冲突：某些输入法或窗口管理器会拦截
Ctrl+\，可改用菜单操作View → Toggle Tree View
多文件夹项目下 Tree View 显示混乱？注意添加方式
Atom 不支持“拖多个文件夹进窗口”这种操作。必须逐个执行 Project → Add Project Folder，每加一个，左侧就会多出一个根节点。但要注意：
- 关闭 Atom 后重启，默认只恢复最后一个添加的文件夹；要持久化多根，必须装
project-manager插件并保存项目 - 如果某文件夹含大量
node_modules或构建产物（dist/、build/），Tree View 渲染会明显变慢，甚至卡死——这时得靠.atomignore排除，内容写成：node_modules/**和dist/** - 两个同名文件夹（如都叫
src）会被合并显示，容易误操作；建议用有意义的顶层目录名（如client/、server/）
图标不显示或全是空白文档图标？file-icons 插件没生效
Tree View 本身不提供文件图标，依赖第三方插件 file-icons。安装后若仍无图标，检查以下几点：
- 是否已重启 Atom？部分版本需重启才加载图标服务
- 是否在设置里启用了「Show file icons」选项？路径：
Packages → file-icons → Settings - 某些文件类型（如
.env、.yml）需要较新版本的file-icons才支持，可运行apm update file-icons升级 - 如果用了自定义主题（如
one-dark-ui），确保图标颜色未被 CSS 覆盖——可临时切换回默认主题测试
真正容易被忽略的是：Tree View 的性能瓶颈不在代码逻辑，而在 DOM 节点数量。哪怕只是展开一个含 500+ 文件的目录，Atom 就可能开始掉帧。这不是配置问题，是 Electron 渲染架构决定的——别硬撑，该加 .atomignore 就加，该拆项目就拆。
