最快排查路径是打开开发者工具（Ctrl+Shift+I）查看Console报错，如“Cannot find module 'fs-plus'”表明缺node_modules或main路径错误，“Failed to activate package”提示依赖缺失或版本不匹配。

看控制台报错是最快路径

Atom 启动或打开文件后，按 Ctrl+Shift+I 打开开发者工具，切到 Console 标签页——90% 的环境依赖问题都会在这里直接暴露。别猜，先看报什么。

常见线索包括：

• Error: Cannot find module 'fs-plus' → 插件缺 node_modules，或 package.json 里 "main" 指向了不存在的文件
• Failed to activate package 'linter-pylint' because it depends on 'linter@^3.0.0' → 缺核心框架，没装 linter
• Command not found: pylint 或 spawn python ENOENT → 插件要调外部命令，但 PATH 里找不到，或路径填错了
• TypeError: fs.existsSync is not a function → Node.js 版本不兼容（比如 linter-jshint 在 Node 16+ 上必挂）

确认插件是否真被激活

很多插件不是“装上就生效”，而是靠 activationHooks 触发，比如 autocomplete-python 必须等 language-python 加载 + 打开 .py 文件才初始化。装完不工作，先检查：

• 右下角状态栏显示的 grammar 是不是对应语言（如 Python，不是 Plain Text）
• 用 apm list --installed 确认插件名和文件夹名完全一致（autocomplete-python 文件夹里 package.json 的 "name" 也得是 "autocomplete-python"）
• 插件根目录是否存在 node_modules？离线拷贝源码 ≠ 可运行态，必须跑过 apm install --production 或 npm install

查外部命令是否可达

像 linter-pylint、php-cs-fixer、latex 这类插件，本质是调系统二进制。它们不读 shell 的 PATH，尤其 GUI 启动 Atom 时更常断层。

验证方式：

• 在终端里执行 which pylint 或 where latexmk，复制输出的**完整绝对路径**
• 进 Atom 设置 → Packages → 对应插件 → 找 Executable Path 或 Builder 字段，粘贴进去，**不要加引号**
• Windows 路径含空格（如 C:\Program Files\...）时，仍不加引号——atom-runner 和 latex 插件内部不解析引号，加了反而截断
• 虚拟环境用户：必须用 venv/bin/pylint 或 .venv\Scripts\pylint.exe，不能填全局 pip install pylint 的路径

版本链断裂是最隐蔽的坑

不是所有“装成功”都等于“能用”。Atom 插件生态依赖三层版本对齐：

• Atom 本体版本：用 apm --version 验证；离线机若装的是 atom-amd64.zip，apm 命令根本不存在
• 插件要求的 Atom 最低版本：查插件 README 里的 engines.atom 字段，比如 "^1.70.0" 就不能塞进 v1.69.0 环境
• 插件依赖的 Node/Electron 兼容性：如 linter-jshint 依赖已停更的 jshint，在 Node 16+ 下静默失效，换 linter-eslint 才行

最麻烦的是这种组合：插件本身没问题，node_modules 也齐全，控制台没报错，但就是不触发——往往卡在某一层版本不匹配，连错误都不抛。