Qt MaintenanceTool 使用国内镜像加速下载（超详细教程）

在使用 Qt 在线安装器 / MaintenanceTool.exe 更新或安装组件时，很多同学都会遇到 下载慢、下载失败 的问题。

其实 Qt 支持自定义镜像源，我们可以用国内高校提供的镜像站来大幅加速下载。

本文将手把手教你，如何让 MaintenanceTool.exe 使用国内镜像。新手小白也能轻松跟上。

---

1. 找到 MaintenanceTool.exe

• 安装好 Qt 之后，在安装目录（一般是 C:\Qt\）里，你会看到一个文件：

  MaintenanceTool.exe

• 这个工具就是用来更新、卸载和安装 Qt 组件的。

---

2. 打开终端

1. 找到 MaintenanceTool.exe 所在的文件夹。

2. 在文件夹的空白处，按住 Shift + 鼠标右键。

3. 在菜单中选择：

   • Windows 11/10 ：点击 "在终端中打开" 或 "在 PowerShell 中打开"。

此时会弹出一个命令行窗口，路径已经自动定位到 Qt 目录，非常方便。

---

3. 输入命令

在终端里输入下面这条命令（注意：前面必须带上 .\）：

.\MaintenanceTool.exe --mirror https://mirrors.nju.edu.cn/qt

然后回车，Qt MaintenanceTool 就会从 南京大学镜像站 拉取资源，而不是从国外服务器下载。

---

4. 如果报错怎么办？

• 问题1：找不到 MaintenanceTool.exe

  👉 说明你忘记写 .\，要完整输入：

  .\MaintenanceTool.exe --mirror ...

• 问题2：403 Forbidden / 文件找不到

  👉 表示镜像站没有你需要的 Qt 版本，可以换一个镜像源。

---

5. 常用国内镜像地址

推荐几个国内比较稳定的 Qt 镜像源：

• 南京大学

  https://mirrors.nju.edu.cn/qt

• 清华大学（推荐）

  https://mirrors.tuna.tsinghua.edu.cn/qt

• 中国科学技术大学

  https://mirrors.ustc.edu.cn/qt

• 上海交通大学

  https://mirror.sjtu.edu.cn/qt

如果一个源不行，就换另一个源。

---

6. 总结

只要在 Qt 安装目录下运行命令：

.\MaintenanceTool.exe --mirror 镜像地址

就能轻松切换到国内镜像，解决 下载慢 / 下载失败 的问题。