Atom自动补全需autocomplete-plus启用、对应语言provider安装及文件grammar正确三者协同；缺一不可，否则cons不会弹出console.log。
Atom 的自动补全不是装个插件就“自动”工作——它必须由 autocomplete-plus 调度，靠对应语言的 provider 提供建议，且文件 grammar 必须匹配。缺任何一环，敲 cons 都不会弹出 console.log。
为什么 autocomplete-plus 启用后还是没补全？
根本问题常不在插件本身，而在执行链断裂：
-
autocomplete-plus状态必须是蓝色 Enabled（不是灰色Install或Disabled），装完不点启用等于没装 - 右下角状态栏显示的 grammar 必须是
JavaScript、Python、HTML等精确名称，不是Plain Text或JS；点它手动切换 - 冲突插件会劫持补全入口：禁用所有带
autocomplete-atom-api、ternjs（非atom-ternjs）、language-babel的插件，它们会让控制台报Cannot read property 'getSuggestions' of undefined - Windows 用户务必重启 Atom——后台进程常驻，新插件不重启根本不加载
不同语言该装哪个 provider？别装错
provider 是补全内容的“大脑”，装错或漏装，autocomplete-plus 就只能返回空列表：
- 写 JavaScript：只装
autocomplete-javascript；别用atom-ternjs（功能重叠易冲突），也别用language-babel替代原生language-javascript（ES6+ 模块导入不响应） - 写 Python：装
autocomplete-python仅补模块名和内置函数（如os.path.后的join）；要参数级提示（如fetch_data(后补url），必须额外装ide-python+python-language-server - 写 HTML/CSS：
autocomplete-html补标签和属性值（如src中当前目录文件），atom-autocomplete-tags更稳；CSS 用autocomplete-css - TS/JS 路径补全：
autocomplete-paths已失效（2021 年归档，不兼容 Atom 1.60+）；改用atom-ide-ui+ide-typescript，需项目根目录有tsconfig.json
补全不弹、卡顿或按 Tab 不生效？查触发逻辑
Atom 默认行为和多数编辑器不同，很多“不工作”其实是预期行为：
- 默认最小触发长度是 2 字符：
c不弹，co才可能弹；若仍不弹，说明 grammar 或 provider 失效 - 确认补全项用
Enter，不是Tab；想用Tab插入并跳转占位符（如print(${1:text})），得在keymap.cson里手动绑定：'atom-text-editor[data-grammar~="source.python"]:not([mini])':<br> 'tab': 'autocomplete-plus:confirm'
- Ctrl+Space 在 Windows/Linux 常被输入法抢占，Mac 上被 Spotlight 占用；打开 Keybinding Resolver（Ctrl+.
），看按键是否被拦截，再自定义快捷键（如 <code>ctrl-alt-space） - 补全慢或 CPU 高？关掉旧版
autocomplete-php、autocomplete-clang或基于外部服务的 provider——它们会频繁扫描node_modules或 fork 进程
HTML/CSS/JSON 里的路径补全根本不可靠
这不是配置问题，是 Atom 架构限制：
-
autocomplete-paths对非 JS/TS 文件完全无效，且已停止维护；强制安装会报Cannot find module 'fs-plus'或atom.project.getPaths is not a function -
autocomplete-html只对src/href属性提供当前目录下的文件名提示，不递归、不支持别名、不识别 Webpack alias - 把项目路径加到
core.projectHome设置里，只能略微提升根目录文件命中率；用Ctrl+Shift+P→autocomplete-plus:activate强制唤出，效果极不稳定 - 真正可靠的路径补全是编辑器底层能力，Atom 无法支撑；现在还在用 Atom 的人，基本靠
Cmd+P快速跳转 + 记忆路径撑下来——这不是技巧，是妥协
