插件解压后不生效，大概率是没进packages目录或路径错；手动安装本质是将插件代码放至Atom扫描路径（macOS/Linux为~/.atom/packages，Windows为%USERPROFILE%.atom\packages），需确保无多余父目录、无云同步干扰，并执行apm install生成node_modules及构建产物。
插件解压后不生效，大概率是没进 packages 目录或路径错
手动安装的本质就是把插件代码放到 Atom 能扫描到的地方。这个位置不是随便选的：~/.atom/packages（macOS/Linux）或 %USERPROFILE%\.atom\packages（Windows）——注意是 packages 文件夹，不是 ~/.atom 根目录，也不是 ~/.atom/installed-packages（这个不存在）。
常见错误包括：
- 把插件文件夹拖进了
~/.atom，结果 Atom 完全无视 - 解压后多了一层父目录（比如下载的是
atom-beautify-master.zip，解压出来是atom-beautify-master/），直接复制整个atom-beautify-master文件夹进去就行，别再往里套一层 - Windows 用户误用 OneDrive 或 iCloud 同步目录，导致
.atom实际在云盘路径下，而 Atom 启动时读的是本地路径
apm install 在本地目录执行失败，原因通常是环境或权限问题
如果你已进入 ~/.atom/packages 目录，运行 apm install xxx 却报 command not found 或卡住不动，先确认两件事：
-
apm是否在系统 PATH 中：终端里直接输入apm --version，能输出版本号才说明可用；macOS 可运行atom --install-shell-commands，Windows 重装 Atom 时务必勾选 “Add to PATH” - 网络是否被拦截：国内用户常遇到
apm install卡在Fetching，加--verbose参数看日志，若出现ENOTFOUND或超时，执行apm config set registry https://registry.npm.taobao.org/换源 - 权限不足：尤其 macOS 上用 Homebrew 装过 Node，
npm install可能因权限拒绝写入node_modules；建议进插件目录后，改用apm install --no-color避免 ANSI 控制符干扰，或直接npm install（前提是该插件支持）
插件文件夹放对了，但功能不触发，关键在激活条件和语言绑定
Atom 不是“装完就用”，它按需加载。很多插件（比如 autocomplete-python、linter-eslint）必须满足特定条件才会初始化：
- 打开一个带正确后缀的文件（如
.py），或手动设置语言模式：快捷键Ctrl+Shift+L（Win/Linux）或Cmd+Shift+L（macOS），输入python并回车，确保右下角状态栏显示Python - 检查插件是否与内置功能冲突：例如
markdown-preview-plus要求禁用 Atom 自带的markdown-preview，否则快捷键Ctrl+Shift+M会失效 - 确认
package.json中"main"字段指向真实存在的入口文件（如"main": "./lib/main.js"），路径错或文件缺失会导致 Atom 加载时直接跳过该包
离线安装时缺构建产物或依赖，node_modules 不可省略
从 GitHub 下载 ZIP 解压后直接扔进 packages 目录，大概率报 Cannot find module 'fs-plus' 或类似错误。这是因为：
- 纯源码仓库（如
atom-simplified-chinese-menu）没有预编译，必须在插件根目录下运行apm install或npm install生成node_modules - 部分插件含原生模块（如
node-spellchecker），需额外运行apm rebuild重新编译，否则启动时报错 - 离线部署前，得确认目标机器已安装匹配版本的
apm（apm --version输出应与插件文档要求一致）
最稳妥的做法：下载 ZIP → 解压 → 进入该文件夹 → 执行 apm install（自动处理依赖和构建）→ 再整体复制进 ~/.atom/packages。
