银河麒麟系统安装PySide6有四种方式：一、pip3安装（推荐，默认用清华镜像）；二、APT安装（稳定适配，需装Qt5运行库）；三、Miniforge+conda安装（多环境隔离）；四、手动编译（高级定制，需Qt6开发套件）。
如果您在银河麒麟系统上已配置Python开发环境，但尚未安装PySide6用于图形界面开发，则可能是由于PySide6未随系统预装、pip源访问受限或Qt依赖库缺失。以下是多种可行的安装路径与适配操作：
一、通过pip3安装PySide6（推荐默认方式）
该方法适用于已配置可用pip3且能正常访问PyPI或国内镜像源的环境，可快速获取最新稳定版PySide6，自动解析并安装基础Qt依赖（如libqt5widgets5等）。
1、打开终端（可通过应用菜单搜索“终端”，或按快捷键Ctrl+Alt+T）。
2、执行命令python3 -m pip --version确认pip3可用；若提示command not found，请先执行sudo apt install python3-pip安装。
立即学习“Python免费学习笔记（深入）”；
3、升级pip至最新版本：python3 -m pip install --upgrade pip。
4、使用清华镜像源安装PySide6：python3 -m pip install PySide6 -i https://pypi.tuna.tsinghua.edu.cn/simple/ --trusted-host pypi.tuna.tsinghua.edu.cn。
5、验证安装结果：python3 -c "from PySide6.QtWidgets import QApplication; print('PySide6 loaded successfully')"。
二、通过APT安装PySide6及Qt运行时依赖
该方式利用系统包管理器安装经麒麟OS适配的二进制包，避免编译开销与ABI兼容性风险，适合对稳定性要求高、不追求最新PySide6小版本的场景。
1、更新软件包索引：sudo apt update。
2、安装Qt5核心运行库：sudo apt install libqt5widgets5 libqt5gui5 libqt5core5a libqt5dbus5 libqt5network5。
3、安装PySide6官方APT包（如麒麟V10 SP1及以上支持）：sudo apt install python3-pyside6 python3-pyside6.qtwidgets python3-pyside6.qtgui。
4、验证模块可导入：python3 -c "import PySide6; print(PySide6.__version__)"。
三、使用Miniforge+conda安装PySide6（多版本隔离方案）
该方法适用于需同时管理多个Python环境、或系统Python受保护无法修改pip源、或需与科学计算栈协同使用的场景；Miniforge基于conda-forge源，对麒麟OS aarch64/x86_64均有良好支持。
1、下载Miniforge安装脚本（x86_64架构）：wget https://github.com/conda-forge/miniforge/releases/latest/download/Miniforge3-Linux-x86_64.sh。
2、赋予执行权限并安装：chmod +x Miniforge3-Linux-x86_64.sh && bash Miniforge3-Linux-x86_64.sh -b -p $HOME/miniforge3。
3、初始化conda并刷新shell配置：$HOME/miniforge3/bin/conda init bash，随后执行source ~/.bashrc。
4、创建专用环境并安装PySide6：conda create -n pyside-env python=3.11 && conda activate pyside-env && conda install -c conda-forge pyside6。
5、测试GUI最小实例：python3 -c "from PySide6.QtWidgets import QApplication, QLabel; app = QApplication([]); label = QLabel('Hello Kylin'); label.show(); app.exec()"。
四、手动编译安装PySide6（仅限高级定制需求）
该方式适用于需启用特定Qt模块（如WebEngine）、或需静态链接、或需适配非标准Qt构建（如自编译Qt6.7）的开发场景；需提前部署完整Qt6开发套件与CMake工具链。
1、安装编译依赖：sudo apt install build-essential cmake python3-dev libclang-dev libssl-dev libxcb-cursor0 libxcb-xinerama0 libxcb-xinput0。
2、下载并安装Qt6（例如Qt6.7.2在线安装器或离线包），确保qmake -v和cmake --version均返回有效输出。
3、设置Qt路径环境变量：export Qt6_DIR=$HOME/Qt/6.7.2/gcc_64/lib/cmake/Qt6（路径依实际安装调整）。
4、克隆pyside-setup仓库：git clone https://code.qt.io/pyside/pyside-setup.git && cd pyside-setup。
5、执行构建与安装：python3 setup.py build --build-type=shiboken --qmake-path=$HOME/Qt/6.7.2/gcc_64/bin/qmake && python3 setup.py install。
