apm install报command not found是因apm未加入系统PATH：Windows需重装时勾选“Add to PATH”或手动添加apm\bin路径；macOS运行atom --install-shell-commands；Linux将apm/bin加入$PATH；国内用户还需apm config set registry换源。
apm install 报 command not found 怎么办
不是插件装不了，是 apm 命令根本没进系统环境变量。Atom GUI 启动时不继承终端 PATH，所以你在终端里能跑的命令，在编辑器里或桌面图标启动时就失效。
- Windows：重装 Atom 时务必勾选 “Add to PATH”；若已安装，手动把
C:\Users\{user}\AppData\Local\atom\app-{version}\resources\app\apm\bin加进系统环境变量 - macOS：先在终端运行
atom --install-shell-commands（需已通过终端启动过 Atom），再重启终端 - Linux：确认用的是官方
.deb或.rpm包，然后把atom/app/apm/bin加入$PATH
国内用户还常卡在 Fetching 或 ENOTFOUND，执行 apm config set registry https://registry.npm.taobao.org/ 换源，再用 apm config get registry 验证是否生效。
插件装了但没反应，到底卡在哪
绝大多数情况不是插件坏了，而是它压根没被激活——Atom 插件有严格的加载条件，不满足就不会初始化。
- 检查语言模式：比如
autocomplete-python只在后缀为.py或语言模式设为Python的文件中才工作；按Ctrl+Shift+L（Win/Linux）或Cmd+Shift+L（macOS）手动切到python，看右下角状态栏是否显示Python - 查
package.json：打开插件目录，确认有"grammars": ["source.python"]或"activationCommands": ["core:save"]这类声明，否则不会自动触发 - 禁用内置冲突插件：如装了
markdown-preview-plus，必须进 Settings → Packages 搜markdown-preview并禁用，否则快捷键和预览功能全失效
离线安装插件为什么白屏或报 Cannot find module
直接把 GitHub 仓库解压扔进 ~/.atom/packages/ 是最常见错误——纯源码没构建，缺 node_modules 和编译产物。
- 克隆或下载插件后，先进入该目录，运行
apm install（优先于npm install，它会匹配 Atom 内置 Node 版本） - 确认
package.json中"main"字段指向有效入口，比如"main": "./lib/main.js" - 含原生模块的插件（如
node-spellchecker）离线部署后，必须运行apm rebuild重新编译，否则require失败
手动下载的 zip 解压后若无 node_modules 文件夹，不能直接扔进 packages 目录。
卸载插件为什么删不干净
图形界面点 “Disable” ≠ 卸载，只是停用，插件文件和配置都还在。真正卸载必须走命令行，且容易漏掉残留。
- 先关掉所有 Atom 进程（macOS 补一句
killall Atom，Windows 任务管理器结束全部atom.exe） - 用
apm list --installed确认包名（注意不是界面上显示的名字，而是package.json里的"name"字段，比如atom-beautify） - 执行
apm uninstall atom-beautify；验证：目录~/.atom/packages/atom-beautify应消失，且apm list --installed输出里不再出现 - 若失败，可手动删文件夹，再打开
~/.atom/config.cson，删掉core: { disabledPackages: ["atom-beautify"] }里的对应项，否则下次启动仍尝试加载
特别注意：某些插件（如 language-julia）被其他插件强依赖，卸载后可能引发连锁报错，apm 不做依赖检查，得自己心里有数。
