插件解压后不生效，先确认是否放对了目录：Atom只扫描~/.atom/packages（macOS/Linux）或%USERPROFILE%.atom\packages（Windows），常见错误包括拖入根目录、多层父目录、云同步路径错位；须进入插件根目录执行npm install（非apm install），确保node_modules和lib/dist存在，并检查activationHooks、依赖插件及外部二进制是否齐备。
插件解压后不生效，先确认是否放对了目录
Atom 只扫描 ~/.atom/packages（macOS/Linux）或 %USERPROFILE%\.atom\packages（Windows）这个固定路径下的子文件夹，其他位置一概无视。常见错误包括：
- 把插件文件夹拖进了
~/.atom根目录，而不是它的packages子目录 - 解压 ZIP 后多了一层父目录（如
atom-beautify-master/），直接复制整个atom-beautify-master文件夹进packages即可，别再套一层 - Windows 用户用了 OneDrive 或 iCloud 同步
.atom，导致实际路径在云盘里，而 Atom 启动时读的是本地路径
npm install 还是 apm install？优先用 npm install
离线环境或网络受限时，apm install 很容易卡住或失败（比如报 ENOTFOUND、gyp WARN install）。npm install 更可靠，因为它只读取本地 package.json，不联网下载 Electron 头文件。
- 进入插件根目录（如
~/.atom/packages/autocomplete-python）后执行npm install - 若提示
command not found，说明npm未在 PATH 中：检查npm --version是否有输出；Windows 用户重装 Node.js 时务必勾选 “Add to PATH” - 部分插件含原生模块（如
linter-gcc），需提前配好node-gyp和 Python 2.7/3.9（看插件文档要求）
装进去了但没反应，重点查 activationHooks 和依赖
Atom 插件不是“复制即用”，很多靠 activationHooks 触发。比如 autocomplete-python 必须同时满足两个条件才会初始化：
- 当前打开的文件后缀是
.py，且语言模式被设为 Python（快捷键Ctrl+Shift+L→ 输入python回车） -
language-python插件已安装并加载（它是前置依赖，离线时必须一并手动装） -
package.json中"activationHooks"字段写对了，例如"language-python:grammar-used"，不能简写成"python" -
"main"指向的入口文件（如./lib/main.js）真实存在，且大小写完全匹配（Windows 下敏感）
node_modules 和构建产物缺失，功能必然瘫痪
只复制源码文件夹，不运行 npm install，require('fs-plus') 这类模块就会报 Cannot find module。更隐蔽的问题是某些插件（如 minimap、atom-ternjs）需要构建步骤：
- 检查插件根目录下是否有
node_modules—— 没它，几乎所有依赖都加载失败 - 检查是否有
lib/或dist/目录 —— 源码 ≠ 可运行态；若没有，看插件 README 是否要求npm run build或apm link - 部分插件（如
go-plus）还依赖外部二进制（gopls），手动安装后仍需额外配置 PATH 或下载对应可执行文件
真正麻烦的从来不是复制文件，而是每个插件对激活时机、依赖粒度、构建要求都不一样。离线部署前，最好先在有网机器上跑通一次 npm install && apm test，看它到底要什么。
