概述
今天聊聊怎么让 Qt Creator 也能用上 AI 大模型。主要是利用 QodeAssist 插件,实现代码自动补全和聊天助手功能,开发体验能提升不少。
环境准备
- Qt 版本:Qt5.14.2
- Qt Creator 版本:17.0.0(独立安装版)
- 插件:QodeAssist
安装插件
去 QodeAssist 的 GitHub Release 页面下载对应版本的插件包。这点很重要,一定要选和你 Qt Creator 版本匹配的,比如 QodeAssist-v0.6.0-QtC17.0.0-Windows-x64.7z。
解压后,把里面的 lib 文件夹直接拖到 Qt Creator 的安装目录里,一般是 C:\Qt\qtcreator-17.0.0。记得重启一下 Qt Creator,不然插件加载不出来。
配置 AI 大模型
打开 编辑 -> Preferences,找到 QodeAssist 选项卡。在 Provider Settings 一栏填入你模型的 API Key。这部分配置很灵活,大家可以根据自己用的模型随便调。
自动补全设置
进 Code Completion 选项,有几个关键参数我踩坑后觉得得改改:
基础开关
- Enable Auto Complete: 总开关,别关。
- Enable Multiline Completion: 允许跨行补全,这个强烈建议开。
- Enable stream option: 流式响应,看着舒服点,推荐开。
- Include context from open files: 包含打开文件的上下文,默认我不建议开,容易干扰。
触发逻辑
- AI suggestion triggers after typing: 触发建议的字符数(0-10),设个 2-3 个比较灵敏。
- character(s) within(ms): 阈值满足的时间窗口(500-5000ms)。
- with delay(ms): 显示延迟时间(10-10000ms),别太快弹出来。
模型参数
- Temperature: 随机性(0.0-2.0),默认 0.2 比较稳。
- Max Tokens: 最大生成长度,按需调整。
- Top P / Top K: 核采样和候选词限制,老手再动。
- Presence / Frequency Penalty: 减少重复内容的惩罚项。
上下文与提示词
- Read Strings Before/After Cursor: 光标前后读取行数,默认 50/30 行通常够用。
- Use System Prompt: FIM 模型的系统提示词。
- Quick Refactor System Prompt: 重构专用提示词,保持默认的 C++/Qt/QML 描述就行。
聊天助手配置
切到 Chat Assistant 页面:
- Chat history token limit: 历史记录 Token 限制,默认 20000,多了就删旧的。
- Sync open files with assistant by default: 默认同步打开的文件,个人建议先关掉,免得上下文太乱或者泄露隐私。

