ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

【GUI桌面开发2】Miniconda + PySide6 环境搭建

【GUI桌面开发2】Miniconda + PySide6 环境搭建

Miniconda + PySide6 环境搭建,Qt Designer可视化GUI布局设计

适合小白,承接前面Miniconda教程,全程Windows,零踩坑,带官方下载链接、路径、完整命令

任务目标

搭建PySide6独立Python虚拟环境,打开Qt Designer,拖拽控件手动布局,保存.ui界面文件。

前置准备:Miniconda工具(已经安装好了)

✅ Windows 64位 Miniconda 官方下载链接

https://repo.anaconda.com/miniconda/Miniconda3-latest-Windows-x86_64.exe

安装要点上一篇已经讲过,再重复说一次。

  1. 路径推荐:D:\miniconda3,不能中文、空格
  2. ✅ 勾选 Add Miniconda3 to my PATH environment variable
  3. 安装完成后关闭所有旧cmd窗口

步骤1:再一次创建PySide6专用虚拟环境,这次是全新的conda环境,之前的环境也要保留

打开Miniconda Prompt (miniconda3)

# 创建环境,名字 pyside6_gui,python3.10conda create-npyside6_guipython=3.10# 输入y确认

激活环境(每次使用前必须激活!)

conda activate pyside6_gui

激活成功标识:终端前缀变成(pyside6_gui)

步骤2:安装PySide6

pipinstallpyside6

安装完成后,所有pyside6工具(designer/uic/rcc/assistant)都在这个环境的Scripts文件夹

📌 工具路径模板(重点!换成你的miniconda安装的路径!)
D:\miniconda3\envs\pyside6_gui\Scripts\
里面包含:

  • pyside6-designer.exe【Qt可视化设计器,本次核心工具】
  • pyside6-uic.exeui转py编译器
  • pyside6-rcc.exe资源编译器
  • pyside6-assistant.exeQt帮助文档

步骤3:查看你电脑上有哪些conda的python环境(确认过名为pyside6_gui环境已经存在的眼神)

condaenvlist

步骤4:两种方式打开 Qt Designer

方式A:命令打开(推荐,激活环境后直接敲)

pyside6-designer.exe

方式B:直接找到exe双击打开

完整路径示例:(重点!换成你的miniconda安装的路径!)

D:\miniconda3\envs\pyside6_gui\Scripts\pyside6-designer.exe


(重点!竖屏电脑显示很适合看代码!)

步骤4:手动拖拽布局GUI界面

  1. 打开Designer后,选择Main Window→ 创建
  2. 左侧控件箱:Push Button按钮、Line Edit输入框、Label标签、Layout布局(水平/垂直布局)直接拖拽到窗口
  3. 调整控件大小、位置,设置控件文字、样式
  4. 【保存】:保存为main.ui,记住保存路径(后面转代码要用这个文件)

文件后缀:.ui,本质是xml格式界面描述文件,不能直接用Python运行,需要uic编译

按红色箭头路线,拖拽到红色的容器中(Layout布局(水平/垂直布局))

可以保存了。

补充:其他配套PySide6工具命令(拓展)

# ui转py(后面任务会用到)pyside6-uic-omain_ui.py main.ui# 资源文件qrc编译pyside6-rcc-ores_rc.py res.qrc# Qt帮助文档pyside6-assistant.exe

讲个语法,一般编译指令都是这个语法(像自然语言的语法:主谓宾定状补),以后不懂就问豆包(最爱唠嗑的智能体)或workbuddy(免费积分根本用不完)。

编译指令 + 选项 + 选项的值 + 输入文件(位置参数)
中间用空格分隔。

常见报错排查

  1. 提示不是内部命令:没有激活 pyside6_gui 环境
  2. 找不到pyside6-designer.exe:确认pip是在激活后的环境里安装的PySide6
  3. 打开Designer闪退:conda环境python版本和pyside6版本不匹配,优先python3.10
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进