Comate补全不触发是因身份认证、进程状态或语言支持未就位；需完成插件安装→百度账号登录→IDE彻底重启三步闭环，检查comate.status状态，关闭代理，验证文件类型与光标位置，并重置缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
百度Comate插件安装后补全功能完全不触发，或只在部分文件中偶尔弹出建议，说明核心AI能力未激活或上下文感知被阻断——这不是网络卡顿或IDE卡死的问题，而是身份认证、进程状态、语言支持三者中至少一项未就位。
确认插件是否真正完成三步闭环
打开VS Code或JetBrains IDE，检查是否已完成【插件安装→百度账号登录→本地进程彻底重启】这三步闭环。仅安装插件但未登录，补全框永远是灰色的；仅登录网页但没切回IDE窗口，插件无法轮询到认证状态；用“重新加载窗口”代替重启，Comate后台服务根本没重建。
Windows/Linux用户按Ctrl+Shift+P → 输入“Developer: Toggle Developer Tools” → 切换到Console标签页，输入comate.status回车。若返回"unauthorized"或"not initialized"，说明闭环断裂。
Mac用户特别注意：Safari或Chrome登录百度账号后，必须保持该浏览器标签页不关闭，直接Alt+Tab切回IDE——插件靠轮询该页面的auth token完成校验，关掉就失效。
检查IDE代理与网络出口设置
方法一：关闭全局代理
进入Settings → Proxy → 将Proxy Mode设为none。Comate不走系统代理，启用后所有请求都会被拦截或超时，导致补全请求发不出去。
方法二：手动配置License（绕过登录验证）
访问https://www.php.cn/link/70492ee8d9012f04330672e37543171a → 复制顶部Username和下方License Key → 在IDE设置中搜索comate.username和comate.license → 分别粘贴保存。这一步能跳过OAuth流程，适用于企业内网或代理白名单受限环境。
【注意】License需与当前登录账号绑定，复制错一行字符会导致整个插件拒绝响应。
验证文件类型与上下文有效性
第一步：确认当前编辑的文件后缀是否在支持列表中。Comate对.java、.py、.go、.ts、.js原生支持；.vue、.jsx需开启“Experimental Language Support”开关；.md、.json、.yml默认不触发补全。
第二步：把光标放在函数体内或类定义内部再按Ctrl+Space。如果光标停在空行、注释区或import语句上，补全引擎不会启动——它只在可推导语义的位置工作。
第三步：选中一段已有代码（比如一个if块），右键选择“Comate: Explain Code”。若解释面板弹出并返回结果，说明模型通道正常，问题出在自动触发逻辑；若报错“no context available”，说明文件未被正确索引或编码格式异常（如含BOM头的UTF-8文件）。
重置Comate本地缓存
① 关闭所有IDE窗口
② 删除Comate缓存目录：
• VS Code：删除~/.vscode/extensions/baidu.baidu-comate-*/cache/
• IntelliJ IDEA：删除~/Library/Caches/JetBrains/IntelliJIdea2023.3/comate/（macOS）或%LOCALAPPDATA%\JetBrains\IntelliJIdea2023.3\comate\（Windows）
③ 重启IDE → 重新登录 → 等待右下角出现“Comate ready”提示。
缓存损坏会导致上下文解析失败，即使登录成功，补全也会表现为“有图标无反应”。这一步比重装插件更快，且不丢失历史会话记录。
