1. 为什么要在 VS Code 里折腾 PyQt5 这套链路如果你写过 Python 脚本多半体会过那种「逻辑跑通了但只能对着黑框框敲命令」的憋屈感。PyQt5 就是来解决这个问题的它把 Qt 那套成熟的 C 图形界面能力包装成 Python 能直接调用的库让你用几十行代码就能弹出真正的窗口、按钮、下拉框。适合谁做小工具、上位机、数据标注面板、内部管理系统的同学尤其是需要快速把算法包一层可视化外壳的场景。但真正让人卡住的往往不是 PyQt5 本身而是环境链路解释器选错、pyuic5 找不到、Qt Designer 起不来、.ui转.py报路径错误再加上现在大家都想让 AI 帮忙补全代码结果补全通道又和项目环境对不上。我试过把这几件事拆开做来回切窗口非常低效所以这篇的目标很明确在 Visual Studio Code 里一次性把 PyQt5 的 GUI 开发环境和 AI 辅助编码链路搭通最后跑出一个能显示的窗口程序并确认补全真的生效。整篇会围绕 VS Code 的settings.json骨架、Python 解释器与 Qt 依赖配置、以及通过统一 Key/API 通道接入 TaoToken 完成补全与调试来展开。所有配置片段都可以直接复制路径部分你按自己的实际目录替换即可。下面先从环境准备讲起再进入可复制的配置最后做验证和排障。2. 前置准备Python 环境、PyQt5 依赖与 TaoToken 通道2.1 建一个干净的虚拟环境不建议在全局环境里装 PyQt5因为pyqt5-tools会带一堆 Qt 二进制文件污染全局后很难清理。用 venv 隔离最省心。假设你的项目目录是D:\work\qt_demo在 VS Code 的集成终端里执行cd D:\work\qt_demo python -m venv venv_qtWindows 下激活venv_qt\Scripts\activatemacOS 或 Linux 下激活source venv_qt/bin/activate激活后终端提示符前面会出现(venv_qt)说明后续 pip 都装进这个环境了。2.2 安装 PyQt5 与 pyqt5-toolsPyQt5 负责运行时pyqt5-tools提供 Qt Designer 和 pyuic5 这些开发工具。用国内镜像装会快很多python -m pip install PyQt5 PyQt5-tools -i https://pypi.tuna.tsinghua.edu.cn/simple装完后验证一下工具是否就位python -c from PyQt5.QtWidgets import QApplication; print(PyQt5 OK)如果打印出PyQt5 OK说明运行时没问题。接着确认 pyuic5 的位置后面配settings.json要用where pyuic5macOS 或 Linux 用which pyuic5。记下这个绝对路径比如D:\work\qt_demo\venv_qt\Scripts\pyuic5.exe。2.3 拿到 TaoToken 的 Key 与 API 地址AI 补全和调试要走统一通道先去控制台创建 Key。打开 https://taotoken.net/api-keys 新建一个 API Key 并复制保存。API 基础地址是https://taotoken.net/api这个地址在配置补全插件时会用到。如果你更想先在网页里试模型效果可以打开 https://taotoken.net/model-chat 直接对话如果打算长期做编码和 Agent 类任务可以了解 https://taotoken.net/coding-plan 的套餐。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 需要看文档时进 https://taotoken.net/doc 。注意Key 只显示一次建议存进密码管理器。不要把它硬编码进会提交到 Git 的文件里。3. 可复制配置settings.json 骨架与 Qt 工具路径3.1 打开并编辑 settings.json在 VS Code 里按CtrlShiftP输入Preferences: Open User Settings (JSON)回车。如果你只想让配置对当前项目生效就在项目根目录建.vscode/settings.json。下面这份骨架把解释器、Qt 工具路径、格式化都放进去了路径部分替换成你自己的{ python.defaultInterpreterPath: D:\\work\\qt_demo\\venv_qt\\Scripts\\python.exe, python.terminal.activateEnvironment: true, pyqt-integration.pyuic.cmd: D:\\work\\qt_demo\\venv_qt\\Scripts\\pyuic5.exe, pyqt-integration.qtdesigner.path: D:\\work\\qt_demo\\venv_qt\\Lib\\site-packages\\qt5_applications\\Qt\\bin\\designer.exe, pyqt-integration.pyuic.compile.filepath: ${workspaceFolder}/${ui_name}_Ui.py, editor.formatOnSave: true, files.associations: { *.ui: xml } }几个关键点解释一下。python.defaultInterpreterPath指向虚拟环境里的 python避免 VS Code 用错解释器导致 import 失败。pyqt-integration.pyuic.cmd和pyqt-integration.qtdesigner.path是 PYQT Integration 插件调用外部工具的入口路径写错就会出现「找不到 pyuic5」或「Designer 无法启动」。pyqt-integration.pyuic.compile.filepath里的${ui_name}_Ui.py决定了.ui转出来的文件名格式我习惯让生成文件带_Ui后缀和手写逻辑文件区分开。3.2 安装 PYQT Integration 插件在扩展面板搜索PYQT Integration安装后重载窗口。装好后右键.ui文件会出现PYQT: Compile Form和PYQT: Edit in Designer两个菜单项。如果没出现多半是插件没激活或工作区没识别到.ui关联检查上面files.associations是否生效。3.3 配置 AI 补全通道VS Code 里能接统一 API 的补全插件有好几种这里以常见的 OpenAI 兼容配置为例。在settings.json里追加{ ai-completion.enabled: true, ai-completion.baseUrl: https://taotoken.net/api, ai-completion.apiKey: 你的_TaoToken_Key, ai-completion.model: claude-sonnet-4-20250514 }不同插件字段名可能不同核心是三样baseUrl 填https://taotoken.net/apiapiKey 填刚才创建的 Keymodel 填你要用的模型名。填完保存重启一下 VS Code 让配置加载。提示如果你的插件支持环境变量读取 Key优先用环境变量别把明文 Key 写进 settings.json 后提交到仓库。4. 验证请求跑通 PyQt5 窗口并确认补全生效4.1 用 Qt Designer 画一个界面在项目目录空白处右键选PYQT: New FormQt Designer 会启动。拖一个Push Button和一个Label到窗口上把按钮的 objectName 改成btnHello标签改成lblMsg。保存为mainwindow.ui到项目根目录。回到 VS Code右键mainwindow.ui选PYQT: Compile Form。目录下会生成mainwindow_Ui.py打开能看到一个Ui_MainWindow类里面定义了控件和布局。4.2 写顶层文件并运行新建app.py内容如下import sys from PyQt5.QtWidgets import QApplication, QMainWindow from mainwindow_Ui import Ui_MainWindow class MainWindow(QMainWindow): def __init__(self): super().__init__() self.ui Ui_MainWindow() self.ui.setupUi(self) self.ui.btnHello.clicked.connect(self.on_click) def on_click(self): self.ui.lblMsg.setText(Hello PyQt5) if __name__ __main__: app QApplication(sys.argv) window MainWindow() window.show() sys.exit(app.exec_())在 VS Code 里按F5或终端执行python app.py。如果弹出一个窗口点按钮后标签变成Hello PyQt5说明 GUI 链路完全通了。4.3 确认 AI 补全生效在app.py里新起一行输入self.ui.btnHello.正常情况补全列表会弹出clicked、setText等成员。如果没弹先看插件状态栏是否显示已连接再检查 Key 和 baseUrl 是否写对。你也可以在注释里写# 给按钮加一个双击事件看模型是否给出self.ui.btnHello.doubleClicked.connect(...)之类的建议。补全生效后写 PyQt5 的信号槽绑定会快很多。5. 本篇常见错排查5.1 报错 Could not find the Qt platform plugin windows这是最经典的坑完整报错类似qt.qpa.plugin: Could not find the Qt platform plugin windows in This application failed to start because no Qt platform plugin could be initialized.原因是 Qt 运行时找不到平台插件目录。解决办法是加一个环境变量变量名QT_QPA_PLATFORM_PLUGIN_PATH变量值指向你虚拟环境里的 platforms 目录例如D:\work\qt_demo\venv_qt\Lib\site-packages\PyQt5\Qt5\plugins\platforms在 Windows 上可以通过系统环境变量设置也可以直接在 VS Code 的launch.json里加env字段。改完重启终端和 VS Code 再运行。5.2 pyuic5 找不到或转换报路径错误先确认pyqt-integration.pyuic.cmd指向的是虚拟环境里的pyuic5.exe不是全局的。如果路径里有空格JSON 里要用双反斜杠转义。转换失败时看输出面板的PYQT Integration频道通常会打印具体命令和错误照着改路径即可。5.3 补全不触发或返回 401401 一般是 Key 无效或没带上。检查apiKey字段是否填了完整 Key有没有多余空格。如果补全完全没反应看插件是否需要重启或者 baseUrl 是否漏了/api。模型名写错有时不会报 401而是直接返回空建议先用 https://taotoken.net/model-chat 确认模型名可用再回填到配置里。5.4 解释器选错导致 import PyQt5 失败如果终端里能 import 但 VS Code 里报红多半是右下角解释器没切到venv_qt。点右下角 Python 版本号选择虚拟环境里的 python。也可以在命令面板执行Python: Select Interpreter手动指定。6. 把这条链路固定下来环境搭通之后日常开发就是「Designer 改界面 → Compile Form → 写逻辑 → AI 补全」这个循环。建议把.vscode/settings.json和requirements.txt一起提交到仓库换机器时pip install -r requirements.txt就能复现。requirements.txt里写PyQt5 PyQt5-toolsKey 不要进仓库用环境变量或本地未跟踪的配置文件。需要长期做编码和 Agent 任务的话可以看看 https://taotoken.net/coding-plan 的额度方案接入文档和字段说明在 https://taotoken.net/doc 里查Key 管理在 https://taotoken.net/api-keys 。把这几步做完你在 VS Code 里的 PyQt5 开发就不再是东拼西凑而是一条能稳定复用的流水线。
