Atom自动补全需同时满足三条件：启用autocomplete-plus、安装对应语言provider、文件被正确识别为该语言语法；缺一则补全空白。
Atom 编辑器的自动补全不是装个插件就“自动好使”，它必须满足三个硬性条件：autocomplete-plus 启用、对应语言的 provider 已安装且匹配当前 scope、文件被正确识别为该语言语法。缺一不可，否则补全框永远空白。
为什么 autocomplete-plus 启用了但没补全？
常见现象是输 cons 没反应，或右下角显示 Plain Text 却以为在写 JS。根本原因不是插件坏了，而是 Atom 根本没把当前文件当目标语言处理。
- 点右下角语法名 → 手动选
JavaScript（不是JS、javascript或JavaScript (JSX)） - 未保存的临时文件默认是
Plain Text，必须先保存为.js后缀才会触发language-javascript -
autocomplete-plus必须是蓝色Enabled状态；灰色Install或Disabled都不生效 - Windows 用户装完务必完全退出再重启 Atom，后台进程常驻会导致新插件不加载
如何让 console.log 补全真正可用？
输 clg 想补 console.log($1)，靠的是 snippets 插件，不是 autocomplete-plus 或 autocomplete-javascript。很多人混淆了“符号建议”和“代码片段”。
- 补全路径必须是
~/.atom/snippets.cson（macOS/Linux）或%USERPROFILE%\.atom\snippets.cson（Windows），放错位置完全无效 - scope 要写准：
"source.js"（JS 文件）、"source.js.jsx"（JSX 文件），不能写成".source.js或javascript - body 中占位符必须从
$1开始连续编号：$1→$2→$3，跳号或重复会导致Tab键跳乱 - 改完
snippets.cson后必须手动重载窗口（Cmd+Shift+P→ 输入Window: Reload），Atom 不监听文件变化
补全卡顿、弹出无关建议怎么办？
默认的 autocomplete-plus 会全局响应字母输入，尤其在字符串、注释里频繁误弹。这不是性能问题，是触发逻辑太宽泛。
- 关掉
Show Suggestions On Keystroke：只保留手动触发（Ctrl+Space），杜绝干扰 - 勾选
Disable Suggestions In Comments和Disable Suggestions In Strings—— 但仅对autocomplete-javascript 1.12+等新版 provider 生效 - 别调
Minimum Word Length到 3 或 4：这会让if、for、let这类关键词永远不提示 - 如果用了
TabNine，必须禁用autocomplete-plus的自动补全，否则两者抢权导致卡死或无响应
Python/PHP 等语言为何参数级补全不出现？
autocomplete-python 和 atom-autocomplete-php 只提供模块名和内置函数补全，它们不解析 AST，也不读类型定义。想补 fetch_data( 后的 url 参数，必须引入语言服务器。
- Python：装
ide-python（它会自动拉取python-language-server），看底部状态栏是否有连接图标；若显示disconnected，说明pip install python-language-server没成功 - PHP：必须配
php-integrator-base+php-integrator-reflection，单装atom-autocomplete-php是白搭 - JS/TS 建议切到
ide-typescript生态，依赖本地tsserver，比原生language-javascript补全强一个数量级 - 所有 LSP 类补全都依赖正确的 scope：Python 是
source.python，PHP 是source.php，写错 scope 就等于没装
最容易被忽略的一点：Atom 的补全能力高度依赖 scope 精确匹配，而 scope 不是凭感觉写的，得用 Ctrl+Shift+P → Editor: Log Cursor Scope 实时查。你看到的 source.js.jsx meta.function-call.js，才是真实生效的链路，少一个环节，补全就静默失效。
