补全建议框不显示，90% 是因 autocomplete-plus 未启用或 provider 缺失；需检查插件启用状态、文件语法识别（右下角非 Plain Text）、对应语言 provider 是否安装，以及系统快捷键是否抢占 Ctrl+Space。
补全建议框不显示，90% 不是 Atom 坏了，而是 autocomplete-plus 插件没启用，或根本没装对 provider。
检查 autocomplete-plus 是否真正启用
很多人以为装了插件就自动工作，其实 autocomplete-plus 安装后默认是 Disabled 状态。它不像 IDE 那样开箱即用，必须手动点 Enable。
- 打开 Atom → Preferences → Packages，搜索
autocomplete-plus - 确认右侧开关是蓝色（Enabled），不是灰色（Install）或已禁用（Disabled）
- 如果看到
autocomplete-atom-api或ternjs（非atom-ternjs）这类旧插件，一并禁用——它们会劫持补全入口，导致控制台报错Cannot read property 'getSuggestions' of undefined - 改完务必重启 Atom：Windows/Linux 上后台进程常驻，不重启新配置可能根本不加载
确认当前文件被识别为正确语言
补全建议为空，大概率是因为 Atom 把你的 .js 文件当成了 Plain Text —— 这时 autocomplete-javascript provider 根本不会启动。
- 看窗口右下角状态栏显示的语法名，必须是
JavaScript、HTML、PHP等，不能是Plain Text - 点它可手动切换；但更可靠的是：确保文件已保存且后缀匹配（比如写 JS 必须是
.js，不是.txt或无后缀） - 不同语言需要对应 provider：
autocomplete-javascript（JS/Node）、autocomplete-html（HTML）、autocomplete-python（Python）——只装autocomplete-plus是不够的
触发方式和快捷键别混淆
补全不是靠 Tab 确认，也不是所有场景都响应 Ctrl+Space。它分三种触发路径，各走各的逻辑。
-
Ctrl+Space：强制唤出当前上下文建议（如刚输完docu想补document），但需先确保Settings → Packages → autocomplete-plus → Show Suggestions On Keystroke已勾选，否则只能靠这个快捷键拉 - 输入字母自动弹出：依赖
Show Suggestions On Keystroke开启 + 当前语言 provider 正常加载 + 编辑器焦点在文本区（不在命令面板或设置页） - 点
.触发属性补全（如arr.弹出push、map）：JS/TS 基本可用，Python 需额外装autocomplete-python，且仅对对象实例有效（const arr = []才行，let arr未赋值则无提示）
系统级快捷键抢占（尤其 Windows/Linux）
Ctrl+Space 在 Windows/Linux 上极大概率被输入法（fcitx、搜狗、微软拼音）拦截，表现为按下去毫无反应，连 Atom 的快捷键解析器都收不到事件。
- 别急着改 Atom 配置，先打开系统输入法设置，关掉「中英文切换」或「虚拟键盘」对应的快捷键（fcitx 用户重点查
Virtual Keyboard选项） - 验证方法：按
Ctrl+.（Windows/Linux）打开 Atom 快捷键解析器，再按Ctrl+Space，看左下角是否显示任何绑定；没显示＝系统层已吃掉 - 更稳妥的方案是换快捷键：在
keymap.cson中加一条，例如：'.platform-win32, .platform-linux': 'ctrl-alt-space': 'autocomplete-plus:activate'
注意别和core:cancel等内置命令冲突
最容易被忽略的点：补全链是“语言识别 → provider 加载 → autocomplete-plus 调度”三级联动，断哪一环都白搭。很多人只盯着插件开关，却忘了右下角那个小小的语法标签才是第一道闸门。
