apm命令未找到主因是atom安装时未配置path，与网络无关；windows需重装并勾选“add to path”或手动添加bin路径，macos运行atom --install-shell-commands，linux用官方deb/rpm包。
apm命令未找到，根本不是插件问题
apm 命令找不到，99% 是 Atom 安装时没把 apm 二进制路径加进系统 PATH，和网络、代理、插件源完全无关。双击图标启动的 Atom 不会继承终端环境变量，所以即使你在终端里能跑 apm --version，Atom 内部仍可能报 “command not found”。
- Windows 用户：默认安装不勾选 “Add to PATH”，必须重装并勾选，或手动把
C:\Users\{用户名}\AppData\Local\atom\bin加入系统环境变量 PATH（注意是Local，不是Roaming） - macOS 用户：运行
atom --install-shell-commands（需先通过终端启动 Atom），然后重启终端再验证apm --version - Linux 用户：确保用的是官方
.deb或.rpm包（如atom-amd64.deb），而非 tar.gz；安装后apm应自动可用；若不行，检查/usr/bin/apm是否存在，或手动将/usr/share/atom/resources/app/apm/bin加入$PATH
验证 apm 是否真正就位
别只看有没有报错，要确认它能完成完整链路。光有 apm --version 输出还不够，得走通初始化流程：
- 运行
apm install --check—— 这会检测 native build tools、Python、node-gyp 等是否就绪，输出Checking for native build tools done才算过关 - 执行
apm list --installed --packages，如果报Cannot find module 'season'，说明apm虽然能启动，但底层模块加载失败，大概率是 Atom 本体安装损坏（比如用了 .zip 绿色版） - 打开 Atom 开发者工具（
Ctrl+Shift+I），输入process.versions.node，确认 Node 版本与当前 Atom 兼容（v1.69.0 对应 v12.x，v1.72.0 对应 v14.x）
搜不到 open-in-browser？名字一个字母都不能错
插件名不是 “Open In Browser” 或 “openbrowser”，官方唯一正确名称是全小写带连字符的 open-in-browser。在 Atom Settings → Install 面板里搜索，必须一字不差输入这个字符串，空格、大小写、连字符缺一不可。
- 常见混淆项：
browser-plus是另一个插件，预览区小且刷新不稳定；atom-html-preview是内嵌渲染，不调系统浏览器，和本需求无关 - 确认已安装：终端运行
apm list --installed --packages，输出中应含open-in-browser@* - 右键菜单不出现？先确保当前编辑器焦点在已保存的
.html文件上，且文件路径不含中文、空格或特殊符号（file://协议硬限制）
离线环境装插件，别碰 npm install
想离线装插件却用 npm install，等于白忙——apm 和 npm 不兼容。插件依赖校验、原生模块编译（如 linter-gcc 的绑定）、postinstall 脚本全部由 apm 驱动，npm install 完全跳过这些步骤。
- 必须用
apm install --production linter-gcc（替换为你需要的插件名），--production关键：跳过devDependencies，避免离线机因缺 Python 或编译工具链而卡死 - 构建机和目标机的 Atom 版本必须完全一致（如都是 v1.69.0），否则激活时报
Cannot read property 'onDidStopChanging' of undefined - 装完检查插件目录下是否有
node_modules，且里面包含实际子模块（如gcc、atom-linter）—— 没这个文件夹，就是无效副本
AtomSetup-x64.exe，macOS 用官网签名 Atom-mac.zip，Linux 用 .deb 或 .rpm）。任何 zip/tar.gz 解压版，apm 都大概率缺失或损坏，后续所有操作都建立在流沙之上。
