apm install 命令不生效主因是 path 未配置：macos 需运行 atom --install-shell-commands，windows 重装时勾选“add to path”或手动添加路径，linux 将 apm/bin 加入 $path；国内网络需换源为 https://registry.npm.taobao.org/。
apm install 命令不生效，大概率是 PATH 没配对
终端里敲 apm install 报 command not found，不是插件问题，而是 apm 根本没进系统路径。Atom GUI 启动（双击图标）不会继承 shell 的环境变量，所以即使你在终端能跑 apm --version，Atom 内部或快捷方式启动后仍可能找不到 apm。
- macOS：先用终端启动 Atom，再执行
atom --install-shell-commands，之后重启终端 - Windows：重装 Atom 时必须勾选 “Add to PATH”；若已安装，手动把
C:\Users\{user}\AppData\Local\atom\app-{version}\resources\app\apm\bin加进系统环境变量 - Linux：确保用的是官方
.deb或.rpm包；若解压安装，需将atom/app/apm/bin手动加入$PATH
联网安装时卡住或搜不到插件，先换 registry 源
国内直连 https://atom.io/api/packages 经常超时或返回空，表现为 apm search 无结果、apm install 卡在 Fetching...、或报 ENOTFOUND。
- 执行
apm config set registry https://registry.npm.taobao.org/（注意是apm config，不是npm config） - 验证是否生效：
apm config get registry应输出刚设的地址 - 某些插件（如
atom-ide-ui）依赖 GitHub Release，若被拦截，可手动下载对应.cson元数据文件，放到~/.atom/.apm/_cache对应路径下绕过请求
离线安装不能直接复制源码，必须用 apm install --production 构建
从 GitHub 下载的 ZIP（如 linter-gcc-v2.0.0.zip）只是源码，不含 node_modules 和编译产物。直接扔进 ~/.atom/packages/，Atom 启动时会报 Cannot find module 'season' 或 Failed to activate package。
- 必须在与目标机 **完全一致版本** 的 Atom（如都是 v1.69.0）下操作
- 进入插件目录后，运行
apm install --production（不带包名！只在已有源码目录下执行） - 检查是否生成了
node_modules，且里面包含atom-linter、fs-plus等子目录 —— 缺一不可 - 禁用
npm install替代：它不触发 Atom 特有的postinstall脚本，原生模块（如gccbinding）必然编译失败
装完插件不生效，别急着重装，先开控制台看报错
重启 Atom 后插件没反应，常见原因不是安装失败，而是激活条件未满足或冲突。
- 打开一个带正确后缀的文件（如
.js），或用快捷键Ctrl+Shift+L（Win/Linux）或Cmd+Shift+L（macOS）手动设置语言模式，确保右下角显示对应语言（如 JavaScript） - 检查是否与内置功能冲突：例如
markdown-preview-plus要求禁用 Atom 自带的markdown-preview - 打开开发者工具（
Ctrl+Shift+I），看 Console 是否有Cannot find module或fetch失败日志 —— 若出现Failed to fetch https://，说明该插件天生不支持离线（如autocomplete-atom-api） - 确认
package.json中"main"字段指向真实存在的入口文件（如"./lib/main.js"），否则加载即失败
真正麻烦的从来不是“怎么装”，而是“装完能不能跑”。很多插件在离线环境下会悄悄失效——不是因为没装好，而是它启动时要拉 GitHub API、动态下载语法文件、或者依赖全局 apm 运行时。这类问题不会报错，只会卡在“Loading…”或根本不出图标，得靠控制台日志才能揪出来。
