代码补全失效主因是autocomplete-plus未启用、provider未加载或grammar识别错误；需检查插件状态、语法设置、provider安装配置，并用atom --safe排除干扰。
代码补全失效，八成不是 Atom 坏了，而是 autocomplete-plus 没启用、provider 没加载、或 grammar 识别错了——三者缺一，补全就静默不响。
确认 autocomplete-plus 已启用且没被屏蔽
很多人装完插件就以为万事大吉，其实 autocomplete-plus 默认安装后是 Disabled 状态。它不启动，整个补全链就断在第一环。
- 打开 Settings → Packages，搜索
autocomplete-plus，右侧按钮必须是蓝色 Enabled（不是灰色Install或Disabled） - 如果刚启用，务必执行 Window: Reload（
Ctrl+Alt+R），尤其 Windows 上后台进程常驻，不重载新状态不生效 - 禁用所有名字带
autocomplete-但非当前语言所需的插件，比如写 JS 却装了autocomplete-php一般无害，但autocomplete-atom-api或旧版ternjs会直接劫持getSuggestions，导致控制台报Cannot read property 'getSuggestions' of undefined
检查当前文件是否被识别为正确 grammar
补全逻辑严格绑定 grammar，不是靠 .js 后缀判断。右下角显示 Plain Text，哪怕你写了 console.log，autocomplete-javascript 就不会启动。
- 点窗口右下角的语法名（如
JavaScript、Plain Text），从弹出菜单里手动选对的语言；注意JavaScript (JSX)和原生JavaScriptprovider 兼容性较差，优先选后者 - 新建未保存文件默认是
Plain Text，必须先保存为.js才会切换 grammar - 在开发者工具 Console 里输入
atom.workspace.getActiveTextEditor()?.getGrammar().scopeName，确认返回的是source.js而不是text.plain
验证对应 language provider 是否真在工作
autocomplete-plus 只是调度器，真正吐出 console.log 或 os.path.join 的是 provider。provider 没装、没配、或配置错，补全就空着。
- 写 JavaScript：装
autocomplete-javascript（轻量、稳定）；atom-ternjs功能强但需项目有.tern-project或jsconfig.json，否则退化为历史词回显 - 写 Python：装
autocomplete-python，并确认jedi版本 ——jedi>=0.19默认关模糊匹配，需在~/.atom/packages/autocomplete-python/settings/autocomplete-python.cson里加'fuzzy': true - 输
log补不出console.log？这不是模糊匹配问题，而是 provider 根本没加载：右下角 grammar 是Plain Text，或atom-ternjs的Enable Provider设置关了，或项目根目录缺.tern-project
用 atom --safe 快速隔离插件干扰
补全突然失效，别急着重装。先运行 atom --safe —— 它跳过所有第三方插件和用户配置，只加载核心功能。如果这时补全正常，问题 100% 出在 ~/.atom/packages/ 或 ~/.atom/config.cson 里。
- Windows 用户必须从 CMD/PowerShell 运行该命令，双击快捷方式无效
- macOS/Linux 若提示
command not found: atom，需先建软链：sudo ln -s /Applications/Atom.app/Contents/Resources/app/atom.sh /usr/local/bin/atom - 安全模式下别试图调试插件——它只是诊断环境。确认问题在插件侧后，进
Settings → Packages，按Last Updated倒序，优先禁用最近更新的几个，尤其是linter-eslint、vim-mode-plus、prettier-atom
最易被忽略的一点：补全失效时若仍显示一堆历史词（比如你以前输过的变量名），说明 provider 彻底没加载，autocomplete-plus 已降级为本地 history 匹配——这和语义补全毫无关系，得先解决 grammar 和 provider 的基础连通性。
