插件安装后不生效，主因是未满足激活条件或依赖未就位：需手动设置语言模式、禁用冲突原生插件，并打开匹配类型文件触发activationHooks。
Atom 编辑器的插件安装本身不难，但真正卡住人的，往往是「装了没反应」「启用了但功能不生效」「多个插件冲突导致崩溃」这三类问题。核心原因不是操作步骤错，而是没理清 Atom 的加载机制和插件依赖链。
apm install 为什么有时不生效
执行 apm install 后插件没出现在「已安装」列表，常见于以下情况：
- 当前终端未在 Atom 插件目录下运行 —— 必须先
cd ~/.atom/packages（macOS/Linux）或cd %USERPROFILE%\.atom\packages（Windows），再运行apm install - 网络被拦截导致包下载失败，但 apm 默认静默失败 —— 加
--verbose参数重试：apm install markdown-preview-plus --verbose，观察输出中是否卡在Fetching或报ENOTFOUND - 插件依赖 Node.js 模块但本地 npm 权限异常 —— 尤其在 macOS 上用 Homebrew 安装过 Node，容易因权限导致
node_modules写入失败；建议改用apm install --no-color避免 ANSI 控制符干扰，或手动进入插件目录后运行npm install
离线安装时 package.json 和 node_modules 缺一不可
直接拷贝插件文件夹到 ~/.atom/packages 后仍不工作？大概率是少了构建产物或运行时依赖。
- 纯源码仓库（如
atom-simplified-chinese-menu）必须先执行apm install或npm install生成node_modules，否则启动时报Cannot find module 'fs-plus'等错误 - 部分插件（如
linter）还依赖全局apm工具链，离线部署前需确认目标机器已安装对应版本的apm（可通过apm --version核对） - 检查插件根目录是否存在有效的
package.json，且其中"main"字段指向正确的入口文件（如"main": "./lib/main.js"），否则 Atom 加载时会跳过该包
插件启用但功能缺失：检查激活条件与语言绑定
比如装了 autocomplete-python 却没有补全提示，不是插件坏了，而是没触发它的激活钩子。
- Atom 插件常通过
"activationCommands"或"grammars"声明激活条件 —— 若打开的是无后缀的临时文件，或文件未设置语言模式（右下角未显示Python），插件根本不会初始化 - 手动设置语言模式：按
Ctrl+Shift+L（Windows/Linux）或Cmd+Shift+L（macOS），输入python并回车，确保状态栏显示Python - 部分插件（如
markdown-preview-plus）要求禁用同名原生插件 —— 进入Settings → Packages，搜索markdown-preview并禁用，否则两者会抢夺Ctrl+Shift+M快捷键
最易被忽略的一点：Atom 的插件加载是惰性的，只有满足 activationHooks（如 "core:opened-file"、"language-python:did-add-grammar"）才会真正 require 对应模块。这意味着即使插件显示「已启用」，它也可能全程处于休眠状态 —— 动手打开一个匹配类型的文件，才是检验是否真生效的第一步。
