Atom本身不自带完整语言级代码提示，所有补全能力均依赖插件组合：autocomplete-plus仅提供框架，真正生成变量、函数签名等建议需安装对应语言的suggestion provider（如atom-ternjs、autocomplete-python等），否则仅回显历史输入。

Atom 本身不自带完整语言级代码提示，所有可用的补全能力都依赖插件组合。直接装 autocomplete-plus 只能回显你打过的词，真要识别变量、函数签名、类成员或 JS/TS 的 import 导出，必须配对安装对应语言的「建议提供商（suggestion provider）」。

为什么 autocomplete-plus 单独用没效果？

autocomplete-plus 是 Atom 的补全框架，不是具体语言引擎。它只负责弹窗、排序、触发逻辑；真正生成候选列表的是后面接的 provider 插件。

• 没装 provider：输入 console. 后什么也不出现，或只列出历史输入过的字符串
• 装错 provider：比如用 autocomplete-python 打开 .js 文件，照样没反应
• provider 未激活：某些插件（如 atom-ternjs）需项目级配置后才生效，光装不配等于白装

不同语言怎么选 provider？

按实际文件后缀和运行环境选，别凭印象装：

• JS/Node.js：atom-ternjs（推荐），需配合 node 和 git，项目根目录生成 .tern-project 才能识别 require 或 ES modules
• TypeScript：atom-typescript（自建语言服务），比 atom-ternjs 更准，但启动慢、内存高
• Python：autocomplete-python，依赖 python-jedi，要求系统有 Python 环境且 pip install jedi 成功
• Java：autocomplete-java，必须提前配好 JAVA_HOME，否则连 String 都补不出来
• PHP：autocomplete-php，靠本地 php CLI 解析 AST，php -v 必须能跑通

常见失效场景与修复动作

补全突然不工作，大概率不是插件坏了，而是环境或配置断了：

• .tern-project 放错位置：必须和 package.json 或 node_modules 在同一级，否则 atom-ternjs 找不到项目上下文
• ESLint 和 Prettier 冲突：如果同时开了 linter-eslint 和 prettier-atom，且都设了保存时自动 fix，可能互相覆盖导致语法树解析失败，补全中断
• Mac 上 Node 路径不一致：GUI 启动的 Atom 读不到终端里的 $PATH，atom --new-window 从命令行启动可继承环境
• 插件加载顺序错：Atom 1.24+ 要求 linter 核心包必须先于 linter-eslint 安装，否则整个 lint 链路静默失效，间接影响部分 provider 的错误感知逻辑

最易被忽略的一点：provider 插件是否真的在当前文件类型下启用。Atom 会根据文件扩展名切换 grammar，但 provider 不一定绑定到该 grammar——比如 autocomplete-java 默认只响应 .java，如果你在 .groovy 里写 Java 风格代码，就得手动在插件设置里添加 grammar 支持。