Atom的autocomplete-plus默认仅支持基础语法，需为JS/Python等语言安装对应provider插件，并确保grammar正确、scope匹配、无冲突插件。
Atom 的 autocomplete-plus 插件默认不工作怎么办
Atom 自带的代码补全能力其实依赖 autocomplete-plus 插件，但它默认只对纯文本、HTML、CSS 等基础语法生效，JavaScript、Python、Go 等语言需要额外配置或安装配套提供者（provider）插件。
常见错误现象：Uncaught TypeError: Cannot read property 'getSuggestions' of undefined，或者敲字母完全没下拉提示。
- 确认
autocomplete-plus已启用：打开 Settings → Packages，搜索autocomplete-plus，确保状态是 “Enabled” - 装对应语言的 provider：比如写 JS 要装
autocomplete-javascript；写 Python 就装autocomplete-python（注意不是atom-python那种 IDE 套件） - 关闭其他冲突插件：像
ternjs或旧版autocomplete-atom-api可能抢占补全入口，禁用后重启 Atom
为什么改了文件类型（grammar）补全还是不触发
Atom 补全逻辑绑定在 grammar（语法高亮类型）上，不是靠文件后缀判断。比如一个 .js 文件如果被手动设成了 “Plain Text” grammar，autocomplete-javascript 就不会加载。
使用场景：常出现在粘贴代码新建临时文件、或从非标准路径打开文件时。
- 看右下角状态栏：显示的是当前 grammar 名，如 “JavaScript”，不是 “JS” 或 “js”
- 手动切换：点击右下角文字 → 选 “JavaScript”（不是 “JavaScript (JSX)” 或 “Babel JavaScript”，除非你真在用 JSX）
- 避免用
language-babel替代原生language-javascript：前者补全支持弱，尤其对 ES6+ 模块导入无响应
自定义 snippet 补全不生效的三个关键点
Atom 的 snippet 补全（比如输入 for 回车出 for 循环）由 snippets 插件驱动，但必须匹配 grammar 和 scope 才会弹出。
参数差异：snippet 的 scope 字段决定它在哪种文件里可用，写错就等于没写。
- scope 必须精确：JavaScript 的正确 scope 是
source.js，不是javascript或.js - 检查 snippet 文件位置：
~/.atom/snippets.cson是全局，project-path/.atom/snippets.cson是项目级，后者优先级更高但容易被忽略 - 修改后不用重启 Atom，但要按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux）→ 输入 “Reload Window” 手动刷新
补全慢、卡顿或 CPU 占用高
autocomplete-plus 默认开启异步请求和缓存，但某些 provider（尤其是基于外部服务的，如 autocomplete-clang 或旧版 autocomplete-php）会频繁 fork 进程或读取 node_modules，导致延迟明显。
性能影响：开 10 个 tab 后补全响应超过 800ms 属常见问题，不是你机器差。
- 关掉“模糊匹配”：Settings → Packages →
autocomplete-plus→ 取消勾选Fuzzy Search，对中文/大小写混输用户尤其有效 - 限制补全来源：在 same package 设置里关掉
Include Completions From All Buffers，避免跨文件扫描 - 慎用
autocomplete-paths：它会实时遍历整个项目目录树，大项目里建议只开Relative Paths，关掉Absolute Paths
补全这件事，核心不在“有没有”，而在 grammar、provider、scope 三者是否咬合。漏掉任意一环，提示就消失——而且 Atom 不报错，只沉默。
