必须启用autocomplete-plus、安装对应语言provider（如autocomplete-javascript或atom-ternjs）、且文件语法识别为source.js，三者缺一不可；cl不补console.log是snippet配置问题，docu不提示document是provider或grammar不匹配所致。
autocomplete-plus 必须启用，autocomplete-javascript 或 atom-ternjs 必须装对，且当前文件语法识别为 source.js（不是 javascript、.js 或 Plain Text）——三者缺一不可，否则敲 cl 不补 console.log，输 docu 也不出 document。
为什么 cl 按 Tab 没反应？查 snippet scope 和 body 编号
代码片段（如 cl → console.log($1)）由 snippets 插件驱动，不依赖 autocomplete-plus。常见失效原因：
-
snippets.cson文件路径放错：macOS/Linux 是~/.atom/snippets.cson，Windows 是%USERPROFILE%\.atom\snippets.cson - scope 写成
javascript或.source.js：必须是source.js（JSX 文件则用source.js.jsx） - body 里占位符断档：
$1后直接写$3，中间缺$2，Tab 就跳乱或卡死 - 多行内容没用三重单引号包裹：
body: 'console.log($1);\n$0'会解析失败，应写成body: '''console.log($1);\n$0'''
为什么输 docu 不提示 document？确认 provider 类型和 grammar 绑定
autocomplete-plus 只调度，真正提供符号建议的是 provider。JavaScript 场景下有两个主流选择：
-
autocomplete-javascript：轻量，只做前缀匹配（docu→document），不支持arr.map(后的参数提示；需确保右下角显示JavaScript（非Plain Text） -
atom-ternjs：支持 ES6+、jQuery、类型推导；但必须项目根目录有.tern-project或jsconfig.json，否则退化为纯历史匹配 - 二者不能共存：同时启用会导致
getSuggestions返回undefined，控制台报错
为什么 Ctrl+Space 按了没弹框？先过 Keybinding Resolver 这关
快捷键失效几乎从不因为 Atom 本身，而是被系统或配置拦截：
- Windows/macOS 中文输入法常劫持
Ctrl+Space：按Ctrl+.（Win/Linux）或Cmd+.（macOS）打开 Keybinding Resolver，输入时看左下角是否显示unbound - keymap.cson 绑定范围太宽：
'atom-text-editor': 'ctrl-space': 'autocomplete-plus:activate'会被其他插件覆盖；应限定 grammar：'atom-text-editor[data-grammar~="source.js"]': 'ctrl-space': 'autocomplete-plus:activate' - provider 已安装但未启用：进 Settings → Packages → 搜
autocomplete-javascript，右侧按钮必须是蓝色Enabled，不是灰色Install
补全总在字符串里弹出来？关掉自动触发，只留手动唤出
默认 Show Suggestions On Keystroke 全局开启，导致写 "hello world" 时也扫变量名，卡顿还干扰。正确做法：
立即学习“Java免费学习笔记（深入）”；
- Settings → Packages →
autocomplete-plus→ 取消勾选Show Suggestions On Keystroke - 保留
Disable Suggestions In Comments和Disable Suggestions In Strings（仅autocomplete-javascript@1.12+等新版支持） - 把
Minimum Word Length设为2：设成3会让if、for永远不提示 - 如需更精细控制（比如只在
.后补属性），用autocomplete-modules或自定义 keymap，别硬调autocomplete-plus的全局行为
