补全不显示，八成是autocomplete-plus未启用、缺少对应语言provider或语法识别错误；需在Settings→Packages中启用autocomplete-plus并安装如autocomplete-javascript等provider，同时确认右下角语法模式为JavaScript等正确类型。
补全不显示，八成是 autocomplete-plus 没启用，或启用了但没配对的语言 provider，再或者右下角语法识别错了——不是插件坏了，是链路断了。
autocomplete-plus 状态必须是 Enabled，不是 Install
Atom 自带的 autocomplete-plus 默认禁用，装完不点 Enable 就等于没装。打开 Settings → Packages，搜 autocomplete-plus，看右侧按钮是不是蓝色的 Enabled；如果是灰色 Install 或 Disabled，点它。Windows 用户尤其要注意：启用后建议重启 Atom，否则后台进程可能根本没加载新插件。
如果控制台报 Uncaught TypeError: Cannot read property 'getSuggestions' of undefined，基本可锁定是 provider 插件缺失或未加载，不是 autocomplete-plus 本身出问题。
JS/Python/HTML 补全必须装对应 provider，不能只靠 autocomplete-plus
autocomplete-plus 只管弹框和键盘导航，真正提供 console.log、os.path.join、<div> 这类建议的，是语言专属的 provider：
- 写 JavaScript：装
autocomplete-javascript（别用atom-ternjs，易冲突；也别用language-babel替代原生language-javascript，补全支持弱） - 写 Python：装
autocomplete-python（注意不是atom-python这种大而全套件；还要确认虚拟环境已激活，且插件设置里填对了 Python 可执行路径） - 写 HTML：装
autocomplete-html或atom-autocomplete-tags（前者轻量只补基础标签；后者支持自动闭合<div></div>和 Tab 补属性，但得确认 scope 是text.html.basic）
别同时启用 autocomplete-html 和 atom-autocomplete-tags，它们注册相同触发范围，会互相抢断，导致补全空白或延迟。
右下角语法名必须匹配，不是后缀名说了算
Atom 补全逻辑绑定在 grammar 上，不是靠 .js 后缀判断。一个 main.js 文件如果右下角显示的是 Plain Text，那 autocomplete-javascript 就不会启动——哪怕你装了十遍。
看右下角状态栏文字，它显示的是当前 grammar 名，如 JavaScript（注意不是 JS、js 或 JavaScript (JSX)）。点击它可手动切换。常见于粘贴代码新建临时文件、或从非标准路径打开未保存文件时，Atom 默认设为 Plain Text。
Vue/React 单文件组件（.vue、.jsx）中，language-html 默认不生效；得装 language-vue 或 language-babel，并确保它们把 <template> 块识别为 text.html.basic scope。
补全卡顿、慢、CPU 占高？先查 provider 是否在瞎忙
某些 provider（比如旧版 autocomplete-php、autocomplete-clang 或基于外部服务的）会频繁 fork 进程、扫描 node_modules 或发起网络请求，导致输入延迟明显，甚至编辑器假死。
禁用 autocomplete-html 和 autocomplete-css 的 “fuzzy search” 选项——模糊匹配在大型项目里极易卡住主线程。
如果补全列表弹出来了但没内容，打开 DevTools（Ctrl+Shift+I），切到 Console，输入 atom.packages.getActivePackage('autocomplete-html').mainModule，看是否返回模块对象；若为 undefined，说明插件根本没加载。
