Atom代码补全需autocomplete-plus框架、对应语言provider及正确作用域三者协同，缺一则仅回显历史输入；如JS需autocomplete-javascript且文件grammar为JavaScript，PHP则需atom-autocomplete-php、php-integrator-base和php-integrator-reflection三者齐全。
Atom 的代码补全不是“装上就灵”的功能，它默认只做最基础的符号级匹配——比如你打 con，它能猜出 console，但绝不会告诉你 console.table() 接收几个参数、第几个是可选对象。真要获得 IDE 级提示，必须明确知道补全由谁提供、在什么作用域生效、哪些插件会互相压制。
autocomplete-plus 为什么经常不工作
它本身只是个“建议分发器”，不解析语法、不读 tsconfig.json、不调用语言服务器。常见失效场景：
- 当前文件作用域不是
.source.js或.source.php（比如你用.jsx却没在config.cson里加映射） - 同时启用了
language-babel和atom-ide-ui，两者都注册了.source.js提供商，结果互相屏蔽 - PHP 补全只装了
atom-autocomplete-php，但没装php-integrator-base，导致连use导入的类名都识别不了 - JS/TS 场景下还依赖
language-javascript自带补全，而它根本不推导函数签名——Array.prototype.map的回调参数名它压根不知道
PHP 补全必须配齐三个包
单独一个插件起不了作用，三者缺一不可，且有严格依赖顺序：
-
atom-autocomplete-php：负责触发和展示，但自己不解析 AST -
php-integrator-base：提供 PHP 语法树解析能力，是整个链条的基石；若缺失，所有类名、方法跳转都失效 -
php-integrator-reflection：用于解析 Composer 加载的第三方类；若禁用，new GuzzleHttp\Client()这类调用将无补全、无跳转
注意：PHP ≥ 8.1 时，php-integrator-reflection 必须升级到 v3.0+ 分支，否则初始化报 ReflectionException；另外，项目根目录别放空的 composer.json，插件会误判为 Laravel 项目并加载冗余分析器，拖慢响应。
JavaScript/TypeScript 应该切到 ide-typescript 生态
想获得类似 VS Code 的参数提示、类型悬停、重命名重构，必须放弃 autocomplete-plus 原生路径：
- 安装
ide-typescript（非language-javascript），它会自动拉起本地tsserver - 项目需存在
tsconfig.json，或至少有node_modules/typescript，否则服务启动失败 - 纯 JS 项目不想配 TS？那就别强求语义补全，改用
javascript-snippets+emmet组合：clg→console.log($1)，bd10→border: 10px solid #000 - 务必关闭
autocomplete-html和autocomplete-css的 “fuzzy search” 选项——模糊匹配在大项目里极易卡顿，且推荐结果常不相关
作用域是补全生效的第一道门槛
几乎所有补全问题，第一步都该查作用域，而不是重装插件：
- 按
Ctrl+Shift+P输入Editor: Log Cursor Scope，看输出是否含你期望的作用域（如.source.ts） - 若文件后缀非标准（如
.vue、.svelte），需手动在config.cson中映射：'*.vue': 'source.vue' - 作用域写错一个字符（比如写成
source.js漏掉点号），整个片段或提供商都不会加载 - 多光标下
Alt+F3只匹配当前作用域内文本，不是全文档——它受语法节点限制，不是正则搜索
补全不是靠堆插件，而是靠对作用域、提供商、语言服务三者关系的精准控制。漏掉任意一环，看到的就只是空白建议框或一堆无关变量名。
