在使用Qoder编写函数、类或配置片段时,如果你光标停在行尾却始终没有看到补全提示,这并非AI出现故障,而是触发机制尚未激活或上下文环境尚未就绪。你必须依次完成登录、开启自动补全开关、等待项目索引这三步,否则即使代码写得很完整,AI也不会主动为你提供补全建议。

确认Qoder插件已启用并完成阿里云账号登录
如果未登录,所有AI补全功能(包括行级与方法级)都会被强制禁用,状态栏不会显示Online标识,意味着功能未生效。这一点没有商量余地:登录是第一步,也是硬性门槛。
对于VS Code用户:打开「设置」→「扩展」→ 搜索“Qoder CN” → 确认状态为「已启用」;若未安装,点击「Install」后务必重启IDE。JetBrains用户:点击「File」→「Settings」→「Plugins」→ 搜索“Qoder” → 安装后同样需要重启IDE。重启完成后,在编辑器右下角状态栏找到Qoder图标,点击并选择「Login with Alibaba Cloud」→ 在浏览器中完成授权 → 返回IDE,待状态栏出现绿色Online标识,才代表真正准备就绪。
手动开启自动补全主控开关
登录成功并不代表万事大吉——Qoder默认关闭自动补全,需要手动开启并调整参数。VS Code:打开「Settings」→ 搜索“qoder auto completion” → 勾选Enable Auto Complete。JetBrains:进入「Settings」→「Tools」→「Qoder」→「Code Completion」→ 同样勾选Enable Auto Complete。建议将AI suggestion triggers after typing设置为3(推荐值),避免输入单个字母就弹出干扰建议;同时启用Enable stream option和Enable Multiline Completion,否则跨行逻辑无法生成。这几个开关缺一不可,请务必逐一确认。
等待项目上下文完成索引
Qoder的补全质量取决于它是否理解你整个项目的结构。首次打开项目时,它会自动扫描源码、依赖、配置文件,构建本地知识图谱。这一步至关重要:在索引完成前强行触发补全,AI只能基于当前文件做浅层猜测,生成的结果往往脱离实际API约束或编码风格。
具体操作:确保当前已打开完整项目根目录(而非单个文件),否则索引范围仅限该文件。观察状态栏,若显示“Indexing project context…”则正在处理,耗时通常为30~90秒。索引完成后,状态栏不再显示进度文字,此时在任意位置键入代码片段或自然语言描述(如“# 读取config.yaml并返回dict”),即可准备触发补全。
用快捷键触发行级/方法级补全
补全不会自动弹窗,必须主动唤醒。将光标置于待补全位置后,按下对应快捷键:macOS按⌥ + P,Windows按Alt + P。触发后,编辑器将以半透明斜体显示「幽灵文字」预览。接受整段建议按Tab;想逐词确认,macOS按⌘ + →、Windows按Ctrl + →;不需要时直接按Esc放弃。注意,快捷键是启动补全的钥匙——不要指望AI自己跳出来,它并没有那么主动。
