Atom默认不启用autocomplete-plus插件，必须手动在Preferences→Packages中搜索并Enable（若未安装则先Install再Enable），启用后需Ctrl+Alt+R重载窗口；补全还依赖正确语法识别（右下角非Plain Text）及对应语言provider（如autocomplete-javascript）。
autocomplete-plus 显示 disabled 或根本没出现在列表里
这不是网络或权限问题，而是 Atom 默认不启用补全核心插件。它装了但处于休眠状态，必须手动激活才能工作。
- 打开 Atom → Preferences → Packages，搜索
autocomplete-plus - 如果右侧显示 Disabled（灰色），点它旁边的 Enable 按钮；如果显示 Install，先点安装再启用
- 启用后务必执行
Window: Reload（快捷键Ctrl+Alt+R），否则旧 UI 缓存可能让设置不生效 - 别装
autocomplete-atom-api或ternjs（非atom-ternjs）这类废弃 provider，它们会劫持补全入口，导致控制台报Cannot read property 'getSuggestions' of undefined
补全框弹不出来，但 autocomplete-plus 已启用
真正起作用的是「语言 provider」，autocomplete-plus 只是弹窗壳子，它本身不提供任何 JS/Python/HTML 的具体建议。
- 确认右下角状态栏显示的不是
Plain Text：点它手动选JavaScript、Python等，或保存文件为.js、.py后缀 - 按语言装对应 provider：
autocomplete-javascript（JS）、autocomplete-python（Python）、autocomplete-html（HTML） - JS 语义补全要更强？装
atom-ternjs，但它依赖系统已装node和git，且需在项目根目录生成.tern-project配置文件 - 点
.触发属性补全时，变量必须已赋值（如const arr = []），未初始化的let arr不会出提示
插件报 Cannot find module 'xxx' 或白屏
这是离线安装或换 Node 版本后最常踩的坑：源码拷进 ~/.atom/packages/ 目录 ≠ 能直接运行，缺 node_modules 或构建产物就必然失败。
- 进插件目录（如
~/.atom/packages/autocomplete-python），运行apm install—— 不要用npm install，它调的是系统 Node，而 Atom 用自己内置的 Node（v12/v14） - 检查
package.json中"main"字段是否指向正确入口，比如"main": "./lib/main.js"，路径错则整个插件被跳过 - 含原生模块的插件（如
spell-check、term3）必须运行apm rebuild（不是npm rebuild），且操作前关掉所有 Atom 进程 - 若
apm install报zlib错误，说明缓存损坏，先跑apm clean再重试
Ctrl+Space 没反应，但其他快捷键正常
Windows/Linux 上这个快捷键大概率被输入法抢走了，Atom 根本收不到事件，不是插件配置问题。
- 检查系统输入法设置：fcitx、搜狗、微软拼音默认绑定
Ctrl+Space切换中英文，必须在输入法配置里禁用或改键 - Atom 内部设置里，确认
Settings → Packages → autocomplete-plus → Show Suggestions On Keystroke已勾选，否则只靠快捷键触发 - 快捷键仅在编辑器文本区生效：焦点不能在命令面板、设置页或侧边栏，否则按键不走补全逻辑
- 补全分三路触发：
Ctrl+Space（强制拉）、输字母（需开启 keystroke）、点.（需 provider 支持），别指望一个快捷键覆盖全部
