atom代码补全需启用autocomplete-plus并安装匹配语言的provider插件，确认语法模式（grammar）正确、scope匹配且无冲突插件，否则补全不生效。
autocomplete-plus 必须装，但它只是个调度器；真正决定补全质量的是 provider 插件，而 provider 的选择必须匹配语言、项目结构和当前 Atom 环境——装错或配错，等于没装。
autocomplete-plus 单独启用后没反应？不是插件坏了
它不生成任何建议，只负责弹窗和排序。输入 console. 后一片空白，是因为没装或没激活对应语言的 provider。
- 检查右下角状态栏显示的 grammar（如
JavaScript），不是文件后缀，也不是JavaScript (JSX)这类变体 - 进 Settings → Packages →
autocomplete-plus→ 确认 Enabled - 重启 Atom：Windows/macOS 上后台进程常驻，不重启新插件可能不加载
- 别信“已安装就自动生效”——provider 插件默认不绑定所有 grammar，得手动确认 scope 是否包含
source.js或source.python
JavaScript/TypeScript 该用 atom-ternjs 还是 ide-typescript？
atom-ternjs 轻量快，但对现代模块解析支持弱；ide-typescript（配合 atom-ide-ui）走 tsserver，类型推导准，但内存高、启动慢。
- 用 ES6+
import、Vite/Next.js/Remix 或 pnpm/yarn workspaces？直接换ide-typescript，autocomplete-modules在这类结构里基本失效 - atom-ternjs 需要项目根目录有
.tern-project或jsconfig.json/tsconfig.json，否则退化为历史词匹配 - Webpack 别名或
dynamic import()场景下，autocomplete-paths必须配合atom-ternjs的projectRoot设置才生效 - Mac 用户注意：
atom --new-window启动才能继承终端 PATH，GUI 直接点开的 Atom 找不到本地node或tsserver
PHP 补全为什么只认 array_ 不认自定义类？
单装 atom-autocomplete-php 不够，它依赖 php-integrator-base 做 AST 解析，还靠 php-integrator-reflection 加载 Composer 类。
- 确认系统
php -v可执行，且插件设置里填对了 PHP CLI 路径（which php输出为准） - 禁用
language-babel或其他语法高亮插件冲突——它们会覆盖source.phpscope，导致 provider 不加载 - PHP ≥ 8.1 时若报
ReflectionException，说明插件未更新，需手动切到php-integrator-reflectionv3.0+ 分支 - 项目根目录别放空的
composer.json，否则插件误判为 Laravel 项目，触发冗余分析拖慢响应
补全卡顿、CPU 占满、Tab 插入错位？关掉这些选项
很多性能问题来自 provider 自身的模糊匹配或文件监听策略，不是 Atom 本身慢。
-
autocomplete-html和autocomplete-css设置里关闭Fuzzy Search，大型项目中它会遍历整个node_modules导致卡死 - 禁用
autocomplete-clang、autocomplete-atom-api等已停止维护的插件，它们仍在 fork 进程读取旧路径 - 多个 autocomplete 插件共存（比如同时启用了
autocomplete-python和atom-autocomplete-php）会互相压制触发逻辑，只留一个主语言的 provider - snippet 补全不生效？检查 scope 字段是否写成
source.js（不是javascript或.js），改完后按Cmd+Shift+P→Reload Window
最易被忽略的其实是 grammar 绑定和 provider 激活状态——哪怕插件列表里显示已安装，只要 scope 不匹配或项目配置缺失，它就安静地当个摆设。
