在 Qt Creator 19.0.0 中配置 GitHub Copilot 的完整记录
从"Sign In 按钮灰色"到愉快使用 AI 代码补全
一、背景
最近尝试在 Qt Creator 中启用 GitHub Copilot 来辅助 C++/Qt 开发。Qt Creator 官方从较早版本就开始集成 Copilot 插件，理论上只需要配置 Node.js 和 Copilot 语言服务器路径即可。但实际配置过程中遇到了"Sign In 按钮始终不可点击"的问题，折腾一番后终于解决。本文将完整记录排查过程和最终方案，希望对遇到类似问题的朋友有帮助。
环境信息：
- Qt Creator：19.0.0（基于 Qt 6.10.2，MSVC 2022，x86_64）
- 操作系统：Windows 11
- Node.js：22.x（已安装并加入 PATH）
- GitHub Copilot：Free 计划（每月 2000 次补全 + 50 次聊天）
二、问题现象
按照官方文档提示，在 编辑 > 首选项 > AI > Copilot 中：
- 正确填写了 Node.js 路径 （
C:\Program Files\nodejs\node.exe） - 下载并指定了
copilot.vim插件中的language-server.js路径 - 但 Sign In 按钮始终为灰色，无法点击登录
Qt Creator 版本是 19.0.0，按理说是比较新的版本，应该对 Copilot 支持良好。但实际情况让人困惑。
三、排查过程
1. 检查基础环境
- Node.js 在命令行能正常执行
node --version→ ✅ - 网络能访问 GitHub 和 Copilot 服务（配置了代理） → ✅
- Qt Creator 中 Copilot 插件已启用（
帮助 > 关于插件中勾选） → ✅
2. 怀疑 language-server.js 路径不对
我最初从 GitHub 克隆了最新的 copilot.vim 仓库：
bash
git clone https://github.com/github/copilot.vim.git其内部确实包含 copilot-language-server/dist/language-server.js 文件。填进去后依然无效。
查阅资料发现，新版 copilot.vim（v1.41+）重构了语言服务器，启动参数发生了变化（需要 --stdio），而 Qt Creator 的 Copilot 插件尚未完全适配新版，导致无法正常拉起语言服务器，因此 Sign In 按钮保持禁用。
3. 尝试降级 copilot.vim
找到 v1.33.0 版本（GitHub Releases 中下载），替换原有插件文件夹。注意：v1.33 中语言服务器文件名为 agent.js 而非 language-server.js。
重新配置路径：
Path to language-server.js: F:\work\copilot.vim\copilot-language-server\dist\agent.js重启 Qt Creator 后，Sign In 按钮终于亮了！
四、最终解决方案（适用于 Qt Creator 19.0.0）
步骤一：下载兼容版本的 copilot.vim
- 访问 https://github.com/github/copilot.vim/releases
- 下载 v1.33.0 的 Source code（zip 或 tar.gz）
- 解压到某个固定目录，例如
F:\work\copilot.vim
步骤二：在 Qt Creator 中配置路径
- 打开
编辑 > 首选项 > AI > Copilot - Node.js path ：选择你安装的
node.exe - Path to language-server.js ：指向
F:\work\copilot.vim\copilot-language-server\dist\agent.js - 勾选
Auto request（可选） - 如果使用代理，填写 Proxy 地址（如
http://127.0.0.1:7890），并可根据需要取消Reject unauthorized
步骤三：登录授权
- 点击 Sign In 按钮
- 弹出设备码窗口，浏览器打开
https://github.com/login/device并输入设备码 - 授权后，Qt Creator 界面会显示已登录状态
步骤四：启用 Copilot
- 勾选
Enable Copilot - 重启 Qt Creator 确保生效
五、验证效果
在代码编辑器中输入注释或函数名，等待几秒即可看到 Copilot 的灰色提示文字，按 Tab 接受补全。也可以手动触发：Ctrl+K 打开定位器，输入 req 选择 Request Copilot Suggestion。
✅ 完美运行！
六、经验总结
-
版本兼容性是最大坑点
Qt Creator 的 Copilot 插件对
copilot.vim的版本敏感。目前已知 v1.33.x 系列 兼容性最好。不要使用最新版（除非你确定 Qt Creator 已更新适配）。 -
注意文件名差异
旧版语言服务器文件名为
agent.js，新版为language-server.js。配置时需确认对应版本的实际文件名。 -
代理环境需配置
国内网络访问 GitHub Copilot 服务可能不稳定，建议在 Qt Creator 中设置 Proxy，并取消
Reject unauthorized（如使用 HTTPS 代理且证书不受信任时）。 -
Node.js 必须可用
确保 Node.js 已安装且 PATH 中包含，或者在设置中直接指定
node.exe绝对路径。
七、附录：GitHub Copilot Free 说明
GitHub 现已推出免费的 Copilot 计划，个人开发者每月可享受：
- 2000 次代码补全
- 50 次聊天交互
足以满足日常 Qt 开发需求，无需付费订阅。
八、结语
虽然配置过程略有波折，但最终能在 Qt Creator 19.0.0 中使用 Copilot，确实显著提升了编码效率。希望这篇记录能帮助同样卡在"Sign In 灰色"问题的开发者快速解决。
如果你有更好的方案或发现新版 Qt Creator 已完美支持最新 copilot.vim，也欢迎交流讨论。
本文首发于个人博客，转载需注明出处。