qt安装加速

Qt 安装加速实用指南

Qt 官方下载服务器位于境外，无论是使用在线安装器（qt-unified）还是通过包管理器拉取依赖，国内网络环境下往往速度缓慢甚至中途断流。本文从镜像源、在线安装器参数、离线包、包管理器四个层面，给出可直接操作的加速方案。

一、为什么 Qt 安装会慢

Qt 的下载分为两部分：

1. 安装器本体：从 `download.qt.io` 拉取，服务器在国外。
2. 组件与元数据：在线安装器会持续请求 `download.qt.io/online/qtsdkrepository/...` 下的组件列表和包体。

慢的根源几乎都在这两处，因此加速的核心思路就是把下载地址替换为国内镜像。

二、在线安装器加速（最常用）

Qt 官方在线安装器支持 `--mirror` 参数，可指定镜像服务器。国内常用镜像如下：

Windows 示例： bat qt-unified-windows-x64-online.exe --mirror https://mirrors.tuna.tsinghua.edu.cn/qt/ Linux / macOS 示例： bash chmod +x qt-unified-linux-x64-online.run ./qt-unified-linux-x64-online.run --mirror https://mirrors.ustc.edu.cn/qtproject/ 启动后，安装器界面中的组件列表会从镜像获取，下载速度通常可提升到带宽上限。若镜像未同步某个组件版本，再临时切回官方源即可。

三、离线安装包

如果只是需要某一个大版本、不想在线拉取，可下载官方离线安装包或归档：

• Qt 官方归档页提供历史上的 `.run` / `.exe` 安装包。
• 部分镜像站点会同步这些归档文件，下载后再本地安装，可完全避开在线组件的请求等待。

离线包体积较大（数百 MB 到数 GB），建议配合下载工具（如 aria2、IDM）多线程下载。

四、包管理器方式（Linux 首选）

如果你在 Linux 上做开发，很多时候并不需要官方安装器，直接用发行版仓库更快：

Debian / Ubuntu： bash sudo apt update sudo apt install qtbase5-dev qtcreator qt5-qmake qtchooser RHEL / CentOS / Fedora： bash sudo dnf install qt5-qtbase-devel qt-creator 同时把系统包源换成国内镜像（如 `mirrors.aliyun.com`、`mirrors.tuna.tsinghua.edu.cn`），`apt` / `dnf` 的下载速度会明显改善。

五、Python 绑定加速（PyQt / PySide）

若你用的是 PyQt5、PyQt6 或 PySide6： bash pip install PyQt5 -i https://pypi.tuna.tsinghua.edu.cn/simple 或永久配置： bash pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple 这些包体积较大，走清华或阿里云 PyPI 镜像可显著提速。

六、辅助手段

• 代理：为安装器或命令行设置 `https_proxy` 环境变量，可整体加速境外请求。
• 关闭无关组件：在线安装器里只勾选真正需要的模块（如 Qt 版本 + 对应编译器 + Qt Creator），减少下载总量。
• 错峰下载：镜像与官方源在夜间通常更稳定。

bash export https_proxy="http://127.0.0.1:7890" export http_proxy="http://127.0.0.1:7890"

七、常见问题

八、小结

Qt 安装加速的本质是换源：

1. 在线安装器加 `--mirror` 指向国内镜像；
2. 能离线就下归档包；
3. Linux 优先走发行版仓库 + 国内 apt/dnf 源；
4. Python 绑定走 PyPI 镜像。

按上述顺序尝试，通常几分钟内即可完成原本漫长的组件下载。