Atom自动补全需autocomplete-plus启用、对应语言provider安装及grammar正确识别三者协同；缺一即失效，常见原因包括插件未启用、冲突插件抢占、scope不匹配或语法识别错误。
Atom 的自动补全不是装完插件就自动弹出，它必须由 autocomplete-plus 调度、对应语言的 provider 提供建议、且当前文件被正确识别为该语言的 grammar —— 三者缺一不可。否则你输 cons 就是没反应，不是 Atom 坏了，是链路断在某一处。
确认 autocomplete-plus 已启用且无冲突
autocomplete-plus 是补全系统的调度中枢，但默认安装后是禁用状态。很多人点了 Install 却没点 Enable，结果全程“零提示”。
- 打开 Settings → Packages，搜索
autocomplete-plus，右侧按钮必须是蓝色 Enabled（灰色 Install 或 Disabled 都不行） - 禁用所有含
autocomplete-atom-api、ternjs（非atom-ternjs）、language-babel的插件——它们会劫持getSuggestions方法，控制台报Cannot read property 'getSuggestions' of undefined - Windows/macOS 上务必完全退出 Atom 再重开，后台进程不杀，新插件根本不会加载
装对 provider 并确保 grammar 匹配 source.js 等 scope
provider 才是真正吐出 console.log、fetch()、os.path.join 的“大脑”。只装 autocomplete-plus，等于买了插座没接电器。
- 写 JavaScript：装
autocomplete-javascript（别用atom-ternjs替代，功能重叠易冲突；也别指望language-babel提供补全，它对 ES6+ 模块导入基本不响应） - 写 Python：基础补全用
autocomplete-python，但要参数级提示（比如fetch_data(后提示url），必须额外装ide-python+python-language-server - 看右下角状态栏文字：必须是
JavaScript（不是JS、JavaScript (JSX)或Plain Text）；点它手动切换，新建未保存文件默认就是Plain Text，哪怕你粘的是 JS 代码 - scope 必须精确匹配：provider 只监听
source.js，你在snippets.cson里写成javascript或.js都无效
让 Tab 键插入补全项并跳转 placeholder
Atom 默认用 Enter 确认补全，Tab 永远只缩进。想输 cl 按 Tab 展开成 console.log(${1:obj}) 并把光标停在 ${1:obj}，得手动绑定。
- 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux）→ 输入Open Your Keymap - 在打开的
keymap.cson里加这段：
'atom-text-editor[data-grammar~="source.js"]:not([mini])': 'tab': 'autocomplete-plus:confirm'
- 如果用了
javascript-snippets，它自带${1:obj}占位符；但autocomplete-javascript本身不提供占位符，Tab 插入后光标不会自动跳转
为什么补全卡顿、慢、或 CPU 占高
补全延迟常被误认为是 Atom 性能差，其实多是 provider 在后台瞎忙——尤其旧版 autocomplete-php、autocomplete-clang 或某些基于外部服务的插件。
- 禁用
autocomplete-html和autocomplete-css设置里的fuzzy search：模糊匹配在大型项目中极易卡死主线程 - PHP 补全必须配齐
atom-autocomplete-php+php-integrator-base+php-integrator-reflection三者，缺一不可；且php-integrator-reflectionv3.0+ 才支持 PHP ≥ 8.1 - 修改
snippets.cson后不用重启 Atom，但必须执行Reload Window（Cmd+Shift+P→ 输入该命令）才能生效
最常被忽略的点：语法识别（grammar）和 scope 匹配是硬性前提，不是“大概对就行”。一个 .js 文件右下角显示 Plain Text，哪怕你装了十个 provider，补全也永远不会触发。
