atom 默认不启用 autocomplete-plus 插件，需手动在 packages 中启用；补全触发方式包括 ctrl+space、输入字母自动弹出、点“.”触发属性补全；失效主因是文件语法识别错误或插件未启用。

Atom 默认不启用代码补全，必须手动开启 autocomplete-plus

Atom 本身不自带完整补全能力，autocomplete-plus 是官方维护的补全插件，但安装后默认处于禁用状态。很多人按 Ctrl+Space 没反应，不是快捷键失效，而是插件根本没开。

• 打开 Atom → Preferences → Packages，搜索 autocomplete-plus
• 确认状态为 Enabled（右侧开关是蓝色），如果不是，点 Enable
• 如果没装，先点 Install，再启用；不要只装不启
• 重启 Atom 不是必须，但启用后建议重启一次，避免缓存干扰

触发补全的三种方式及对应场景

补全列表不是只靠 Ctrl+Space，不同场景下有效触发方式不同：

• Ctrl+Space：强制唤出当前上下文的补全项（比如刚输完 docu 想补 document）
• 输入字母自动弹出：需满足两个条件——autocomplete-plus 已启用 + 当前文件有对应语言支持（如 .js 文件需有 language-javascript）
• 点 . 后自动触发对象属性补全（如 arr. 弹出 push、map 等），但仅对部分语言生效（JS/TS 基本可用，Python 需额外装 autocomplete-python）

常见补全失效原因和排查顺序

补全“不工作”时，90% 是环境配置链断了一环，按这个顺序查最省时间：

智谱清言

智谱清言是一款AI工具，智谱推出的全能AI助手。

下载

• 检查当前文件是否被识别为正确语言：看窗口右下角显示的语法名（如 JavaScript），不是 Plain Text；点它可手动切换
• 确认 autocomplete-plus 插件已启用，且没有被其他插件（如旧版 autocomplete）冲突禁用
• 某些语言需要额外补全包：autocomplete-go、autocomplete-ruby、atom-ide-ui（含类型感知）等，纯 autocomplete-plus 只管基础符号
• 检查设置里 Settings → Packages → autocomplete-plus → Show Suggestions On Keystroke 是否勾选；未勾选则只能手动 Ctrl+Space

快捷键冲突和自定义绑定

Windows/Linux 下 Ctrl+Space 常被系统输入法抢占，Mac 上 Cmd+Space 是 Spotlight。这时候别硬调系统，直接改 Atom 键位更可靠：

• 打开 Atom → Keymap...，点击右上角 Toggle Keybinding Resolver（或按 Ctrl+.）
• 在编辑器里按键，看左下角显示哪个命令被触发、是否被拦截
• 在 keymap.cson 中添加自定义映射，例如：

'.platform-win32, .platform-linux':
  'ctrl-alt-space': 'autocomplete-plus:activate'

注意：新快捷键不能和 Atom 内置命令冲突（如 core:cancel），否则优先执行内置行为

Atom 的补全依赖插件链和语言识别精度，不是装了就灵；最常被忽略的是文件语法未正确识别，以及 autocomplete-plus 虽已安装却未启用——这两步没做，后面所有设置都白搭。