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安装要点上一篇已经讲过,再重复说一次。
- 路径推荐:
D:\miniconda3,不能中文、空格 - ✅ 勾选 Add Miniconda3 to my PATH environment variable
- 安装完成后关闭所有旧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界面
- 打开Designer后,选择
Main Window→ 创建 - 左侧控件箱:Push Button按钮、Line Edit输入框、Label标签、Layout布局(水平/垂直布局)直接拖拽到窗口
- 调整控件大小、位置,设置控件文字、样式
- 【保存】:保存为
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(免费积分根本用不完)。
编译指令 + 选项 + 选项的值 + 输入文件(位置参数)
中间用空格分隔。
常见报错排查
- 提示不是内部命令:没有激活 pyside6_gui 环境
- 找不到pyside6-designer.exe:确认pip是在激活后的环境里安装的PySide6
- 打开Designer闪退:conda环境python版本和pyside6版本不匹配,优先python3.10