apm search返回空或超时的根本原因是默认registry被拦截，需单独执行apm config set registry https://registry.npm.taobao.org/并用apm config get registry验证，再运行apm install --check确认就绪。
apm search 返回空或超时，不是网络断了，是 registry 被拦截
国内用户执行 apm search 无结果、apm install 卡在 “fetching…” 或报 ENOTFOUND / ETIMEDOUT，根本原因不是你本地网络异常，而是 apm 默认连的 https://registry.npmjs.org/ 在国内不可达。
它不读系统 npm config，必须单独配：
- 运行
apm config set registry https://registry.npm.taobao.org/ - 验证：执行
apm config get registry，输出应为刚设的地址 - 改完后必须运行
apm install --check，看到Checking for native build tools done才算真正就绪
插件装上了但搜不到、不生效，大概率是 Node 版本没对齐
Atom 自带独立 Node（v12.x/v14.x），和系统 Node 无关。插件显示“已启用”，但快捷键没反应、语法高亮不工作，90% 是因为原生模块未用 Atom 内置 Node 重编译。
- 关闭所有 Atom 窗口（包括后台进程）
- 运行
apm rebuild—— 这会强制用当前 Atom 的 Node 重新构建所有插件 - 别用
npm rebuild，它调的是系统 Node，完全无效 - 若报 zlib 错误，先
apm clean清缓存再重来
ask-stack 插件搜不到 Stack Overflow 结果，不是插件坏了，是关键词和上下文没给对
ask-stack 不走官方 API，靠解析网页 HTML，对关键词组合、网络、页面结构都敏感。默认行为容易让人误判为“失效”。
- 安装后必须重启 Atom，否则
ask-stack:search命令不会注册进命令面板 - 别只输函数名如
fetch，要带上下文，比如javascript fetch api cors error - 若控制台报
net::ERR_CONNECTION_TIMED_OUT，说明本地无法访问stackoverflow.com，需配代理或改用proxychains4启动 Atom - 连续失败 3 次后，插件会静默降级为仅展示缓存标签页，不报错也不提示
手动安装插件后仍不加载，缺的是 node_modules 和构建产物
从 GitHub 下载源码 ZIP 或 git clone 到 ~/.atom/packages/ 后直接重启，90% 会失败。Atom 启动时不自动 npm install，也不会生成 node_modules。
- 进入插件目录（如
~/.atom/packages/linter-gcc） - 运行
apm install --production（--production不可省，跳过 dev 依赖） - 确认目录下生成了
node_modules，且含插件声明的依赖（如gcc、atom-linter） - 版本必须严格一致：离线机是 Atom v1.69.0，构建机也得是 v1.69.0，否则 API 方法缺失会静默崩溃
autocomplete-atom-api 启动时拉 GitHub 文档，platformio-ide 强制校验云端 toolchain，这类插件即使把 node_modules 全拷过去，控制台也会卡在 Failed to fetch https://...。
