Atom项目管理需三要素：Project模块添加文件夹、tree-view渲染、插件补持久化；拖拽或单文件无法触发目录树，≥1.60版须用project-plus替代已废弃的project-manager。
Atom 本身没有“代码管理”功能，所谓项目目录管理，本质是靠 Project 模块叠加文件夹 + tree-view 渲染 + 插件补足持久化，三者缺一不可。硬要拖文件夹进窗口、点右键“打开所在目录”、或指望单个文件自动带出整个项目结构，都会失败。
Tree View 为空？先确认项目是否真正加载
Tree View 不是“打开文件就自动有”，它只响应 Project 系统注册的路径：
- 必须通过
Project → Add Project Folder（快捷键Cmd+Shift+O/Ctrl+Shift+O）显式添加——拖拽文件夹进窗口、双击文件、右键 Reveal in Finder 后再拖入，全部无效 - 检查
Packages → tree-view是否启用（开关为 Enabled，非灰色 Disabled） - 按
Cmd+\（macOS）或Ctrl+\（Windows/Linux）强制显示/隐藏 Tree View，有时焦点没落在它上面会导致空白 - 如果用了
vim-mode，快捷键可能被拦截，先按Esc退出插入模式再试
多个文件夹怎么并列显示又不丢？别碰 projects.cson
Atom 内置的多项目支持是内存态的：关掉再开，只剩最后一个添加的文件夹。想保存 A+B+C 这组结构，必须用插件，但注意版本兼容性：
- Atom ≥ 1.60 时，
project-manager已彻底废弃，安装会报No available version compatible—— 这不是你操作错，是 API 被删了 - 正确替代是
project-plus：运行apm install project-plus，添加完所有文件夹后，用命令面板执行Project Plus: Save Workspace，起名如my-backend -
project-plus不读写~/.atom/projects.cson，避免因语法错误导致 Atom 启动卡死 - 不用插件时，唯一可靠方式是终端启动：
atom /path/to/A /path/to/B，但无法动态增删
搜索不到新文件？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/**
为什么改了 ignored names 还是显示 node_modules？两层开关必须都开
Atom 的“忽略”是两级控制，只设一层等于白设：
- 第一层：在
Settings → Core → Ignored Names中填入名称，例如node_modules、.DS_Store（注意：不支持通配符如*.log，也不支持路径如build/**） - 第二层：进入
Packages → tree-view → Settings，必须勾选Hide Ignored Names - 如果是 Git 仓库，还可额外开启
Hide VCS Ignored Files，这样.gitignore里的条目也会被隐藏（优先级低于Ignored Names列表） - 改完设置后无需重启 Atom，按
Cmd+\隐藏再显示一次 Tree View 即可生效
真正容易被忽略的是：Tree View 只渲染已注册的项目路径，它和右键菜单里的 “Open in Terminal” 或 “Copy Full Path” 完全无关；那些操作只作用于已有节点，不能反向触发项目加载。项目管理的入口永远在顶部菜单栏的 Project 下，而不是 tree-view 的右键菜单里。
