Atom自动补全失效的根本原因是执行链断裂：autocomplete-plus未启用（需为蓝色Enabled）、右下角grammar未匹配（如JavaScript而非Plain Text）、provider插件缺失或冲突。

Atom 插件不是装上就生效，必须满足语法识别、补全引擎、触发逻辑三者协同，缺一环就卡在 cons 不弹 console.log。

为什么 autocomplete-plus 装了却没反应？

根本问题常出在执行链断裂，而非插件本身失效：

• autocomplete-plus 状态必须是蓝色 Enabled（灰色 Install 或 Disabled 都不算）
• 右下角状态栏显示的 grammar 必须精确为 JavaScript、Python、HTML 等，不是 Plain Text 或模糊的 JS；点它可手动切换
• 冲突插件会劫持补全入口：禁用所有含 autocomplete-atom-api、ternjs（非 atom-ternjs）、language-babel 的插件，否则控制台报 Cannot read property 'getSuggestions' of undefined
• Windows 用户务必重启 Atom——后台进程常驻，新插件不重启根本不加载

不同语言该装哪个 provider？

provider 是补全内容的“大脑”，装错或漏装，autocomplete-plus 就只能返回空列表：

• 写 JavaScript：只装 autocomplete-javascript；别用 atom-ternjs（易冲突），也别用 language-babel 替代原生 language-javascript（ES6+ 模块导入不响应）
• 写 Python：装 autocomplete-python 仅补模块名和内置函数（如 os.path. 后的 join）；要参数级提示（如 fetch_data( 后补 url），必须额外装 ide-python + python-language-server
• 写 HTML/CSS：autocomplete-html 补标签和属性值（如 src 中当前目录文件），atom-autocomplete-tags 更稳；CSS 用 autocomplete-css
• TS/JS 路径补全：autocomplete-paths 已失效（2021 年归档，不兼容 Atom 1.60+）；改用 atom-ide-ui + ide-typescript，需项目根目录有 tsconfig.json

补全不弹、卡顿或按 Tab 不生效？查触发逻辑

Atom 默认行为和多数编辑器不同，很多“不工作”其实是预期行为：

• 默认最小触发长度是 2 字符：c 不弹，co 才可能弹；若仍不弹，说明 grammar 或 provider 失效
• 确认补全项用 Enter，不是 Tab；想用 Tab 插入并跳转占位符（如 print(${1:text})），得在 keymap.cson 里手动绑定：
  'atom-text-editor[data-grammar~="source.python"]:not([mini])': 'tab': 'autocomplete-plus:confirm'
• Ctrl+Space 在 Windows/Linux 常被输入法抢占，Mac 上被 Spotlight 占用；打开 Keybinding Resolver（Ctrl+.），看按键是否被拦截

最常被忽略的是 grammar 切换和 provider 匹配——哪怕 autocomplete-plus 显示已启用，只要右下角写着 Plain Text，补全就永远不启动。