Atom自动补全需autocomplete-plus、对应语言provider及正确语言识别三者协同；缺一不可，常见问题包括插件未启用、冲突插件抢占、语法识别错误或触发方式不当。
Atom 的自动补全不是开个开关就“全自动”——它依赖插件链协同工作，缺一环就完全不弹建议。核心是 autocomplete-plus + 对应语言的 provider（比如 autocomplete-javascript）+ 正确的语言识别，三者都到位才能看到补全列表。
确认 autocomplete-plus 已启用且没被冲突插件屏蔽
这是最常卡住的第一步。很多人装了插件但没点 Enable，或者同时装了旧版 autocomplete-atom-api 或 ternjs（非 atom-ternjs），它们会抢占补全入口，导致 autocomplete-plus 的 getSuggestions 方法返回 undefined，控制台报错 Uncaught TypeError: Cannot read property 'getSuggestions' of undefined。
- 打开 Settings → Packages，搜
autocomplete-plus，右侧必须是蓝色 Enabled，不是灰色Install或Disabled - 禁用所有名字带
autocomplete-但不是你当前语言所需的插件（比如写 JS 却装了autocomplete-python，一般无害；但autocomplete-atom-api必须关） - 重启 Atom —— Windows 上尤其重要，后台进程不退出，新插件可能根本不加载
装对 provider 并确保文件被识别为对应语言
autocomplete-plus 本身不提供任何建议，它只是调度器。真正吐出函数名、变量、标签的是 provider。你敲 docu 想补 document，靠的是 autocomplete-javascript；敲 <di> 想补 <code><div>，靠的是 <code>autocomplete-html。provider 没装，或装了但 Atom 不知道你在写什么语言，补全就永远为空。
- 检查右下角状态栏显示的语法名：必须是
JavaScript、HTML、PHP等，不能是Plain Text；点它可手动切换 - 文件后缀必须匹配：写 JS 必须保存为
.js，否则language-javascript不加载，provider 就不会启动 - 按语言装 provider：
autocomplete-javascript（JS/Node）、autocomplete-html（HTML）、atom-autocomplete-tags（更稳的 HTML 标签闭合）、autocomplete-php（PHP）、autocomplete-python（Python）
触发补全的方式和快捷键别搞错
很多人输几个字母没反应，第一反应是“坏了”，其实是触发方式不对。Atom 默认不靠 Tab 确认补全项，也不靠 Ctrl+Space 在所有场景生效。
- 默认自动弹出需满足两个条件：已启用
autocomplete-plus+ 当前文件有 provider 支持 + 输入 ≥2 字符（默认最小长度） - 强制唤出：按
Ctrl+Space（Windows/Linux）或Cmd+Space（Mac），但如果系统级输入法占用了这个组合键，左下角 Keybinding Resolver 会显示unbound—— 此时得改 Atom 键位，比如绑到Ctrl+Alt+Space - 确认补全项用
Enter，不是Tab；若坚持用Tab，要在 Keymap 里加自定义映射，但注意缩进时可能误触发 - 点
.后自动补对象属性（如arr.弹push、map），仅 JS/TS 原生支持，Python 需额外插件
项目级变量补全要额外配 ctags 或 atom-ternjs
基础补全只管语法关键词（function、if）、内置 API（console.log）、HTML 标签名。你自己写的 const apiHost = "https://api.example.com" 或 class UserService，默认根本不会出现在列表里 —— 这不是 bug，是设计如此。
- 要补项目内定义的函数、变量、类，必须上
atom-ctags+autocomplete-ctags，或直接用atom-ternjs（JS/Node 场景首选） -
atom-ternjs需在项目根目录建.tern-project，内容至少含{"ecmaVersion":6,"libs":[],"plugins":{"node":{}}}；Mac 下常需加"loadEagerly":["**/*.js"]才生效 - 装完 provider 后，务必执行
Packages > Atom Ternjs > Restart server，否则配置不加载
最容易被忽略的是语言识别和 provider 的绑定关系：Atom 不靠文件名猜语言，而靠 grammar scope；scope 错了，再好的 provider 也喂不进数据。补全失效时，先盯住右下角那个小字，比翻设置快十倍。
