Tree View 为空是因为未通过 Project → Add Project Folder 显式添加项目路径；需确认 tree-view 已启用、快捷键未被 vim-mode 拦截，并检查忽略规则与索引状态。
Tree View 为什么为空？先确认项目是否真正加载
Tree View 不是“打开文件就自动有”，它只响应 Project 系统注册的路径。你双击一个 .js 文件、右键 “Reveal in Finder” 再拖进窗口、甚至把整个文件夹拖到 Atom 窗口里——这些操作全部无效。
必须通过 Project → Add Project Folder（macOS 快捷键 Cmd+Shift+O，Windows/Linux 是 Ctrl+Shift+O）显式添加。每次加一个，加几次，树视图就显示几个并列根节点。
- 检查
Packages → tree-view是否为 Enabled（不是灰色的Disabled） - 按
Cmd+\（macOS）或Ctrl+\（Windows/Linux）强制显示/隐藏 Tree View，有时焦点没落在它上面会导致空白 - 如果启用了
vim-mode，快捷键可能被拦截，先按Esc退出插入模式再试
多个项目文件夹怎么并列显示又不丢？别碰 projects.cson
Atom ≥ 1.60 版本中，project-manager 已彻底废弃，安装会报 No available version compatible——这不是你操作错，是底层 API 被删了。
正确替代是 project-plus：运行 apm install project-plus，添加完所有文件夹后，用命令面板执行 Project Plus: Save Workspace，起名如 my-backend。它不读写 ~/.atom/projects.cson，避免因语法错误导致 Atom 启动卡死。
- 不用插件时，唯一可靠方式是终端启动：
atom /path/to/A /path/to/B，但无法动态增删 - 手动编辑
projects.cson风险极高，Atom 启动卡死或无法打开都可能发生 -
Project: Switch Project命令只列出当前工作区中已显式添加的根目录，不是历史记录
Fuzzy Finder 搜索不到新文件？索引不是实时的
Cmd+P（Fuzzy Finder）依赖后台索引，刚加完文件夹或新建文件不会立刻出现。等待 2–3 秒，或手动触发重建：Cmd+Shift+P → Fuzzy Finder: Rebuild Index。
- 确认文件在已添加的项目根目录下（不是嵌套在未添加的父目录里）
- 检查是否被忽略：
core.ignoredNames默认含node_modules、.git、build，这些目录下的文件不会进搜索 - 若项目含大量小文件（如未忽略的
node_modules），建议在项目根加.atomignore，写入node_modules/**和dist/**
图标不显示、搜索卡顿、侧边栏变慢？忽略规则要设两层
Atom 的“忽略”是两级控制，只设一层等于白设：
- 第一层：在
Settings → Core → Ignored Names中填入名称，例如node_modules - 第二层：确保
tree-view的Show Icons开关开启，且file-icons插件已装兼容版（v2.1.45）并启用Show icons in tree view - 多项目下性能敏感点不在 Atom 本身，而在目录是否被合理忽略——未过滤的
node_modules会让树渲染、搜索、甚至大文件警告频繁弹出
真正容易被忽略的是：ignoredNames 设置后必须重启索引，且 .atomignore 优先级高于全局设置；改了配置不重载窗口，等于没改。
