atom 默认不提供 atom 命令，需手动安装命令行工具：macos 通过菜单安装、windows 安装时勾选“add to path”、linux 部分发行版自动注册；atom . 不清空旧项目，应使用 atom -n .；--wait 仅对新实例有效，已有进程下立即返回。
Atom 不能用 atom 命令直接打开，除非你手动安装了命令行工具——它默认不带，装了也容易失效。
为什么 atom 命令在终端里报 “command not found”
Atom 安装包（macOS 的 .dmg、Windows 的 .exe、Linux 的 .deb/.rpm）默认不写入系统 PATH，也不会自动创建 shell 命令别名或软链接。atom 不是系统自带命令，也不是 npm 全局二进制，它只是 Atom 自己提供的可选脚本。
- macOS：需要在 Atom 菜单栏点
Atom → Install Shell Commands，本质是把/Applications/Atom.app/Contents/Resources/app/apm/bin/atom复制到/usr/local/bin/atom - Windows：安装时勾选 “Add to PATH” 才可能生效；若没勾，得手动把 Atom 安装目录下的
resources\app\apm\bin\atom.cmd所在路径加进系统环境变量 - Linux（.deb/.rpm）：部分发行版打包时会注册
atom命令，但 Arch 或从源码运行的版本基本没有
执行 atom . 却打开了旧项目或空白窗口
这是 Atom 缓存了上次会话状态，不是路径没传进去。它优先恢复上一个窗口的项目树和打开的标签页，. 只是附加加载当前目录，不会清空原有内容。
- 想真正用命令行“新建窗口打开当前目录”，得加
-n参数：atom -n . - 如果还连带恢复上次编辑位置，再加
--clear-window-state（Atom 1.60+ 支持） - 注意：某些插件（比如
project-manager）会劫持项目加载逻辑，关掉它们再试
atom --wait 在脚本里不阻塞，或者卡住不返回
--wait 的作用是让终端挂起，等 Atom 窗口关闭后再继续执行后续命令——但它只对“通过该命令启动的新 Atom 实例”有效。如果 Atom 已在运行，atom --wait . 实际是向已有进程发消息，不触发新进程生命周期，所以立刻返回。
- 可靠做法：先确保无 Atom 进程，再用
atom --wait -n . - macOS 下可用
pkill -f 'Atom.*\.app'清理；Linux/Windows 类似 - CI 或自动化场景别依赖
--wait，它不是为这类用途设计的，容易因 IPC 延迟或权限问题失败
最麻烦的其实是 macOS 上 Install Shell Commands 选项偶尔灰掉——通常因为 Atom 没以管理员权限运行过，或者 /usr/local/bin 不可写。这时候手动 ln -s 更稳，但得记得每次更新 Atom 后检查链接是否指向新版路径。
