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 镜像地址

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

相关推荐
ShineWinsu10 小时前
对于Qt:QGripLayout常见属性、方法以及QSizePolicy的解析
开发语言·c++·qt·面试·gui·客户端·网格
艾莉丝努力练剑11 小时前
【AI大模型接入SDK】C++的SessionManager 线程安全
java·开发语言·前端·c++·人工智能·学习·安全
利威尔xu11 小时前
Go Mutex 饥饿模式:正常模式等待者饿死,1ms 阈值自动切换崩溃
开发语言·后端·面试·golang·并发编程
乌暮13 小时前
少写重复 CRUD:用大白话搞懂 MyBatis-Plus
java·开发语言·spring boot·面试·mybatis
不绝19113 小时前
Lua基础语法入门:注释、变量类型与字符串操作
开发语言·lua
Hhy_110713 小时前
《C++深度解构07》手撕 vector —— 从底层三指针架构到迭代器失效彻底吃透
c语言·开发语言·c++·学习·visual studio
风落青芜14 小时前
链式二叉树的实现与基本操作
c语言·开发语言·数据结构·算法
艾莉丝努力练剑14 小时前
【QT】系统相关:TCP的API介绍
开发语言·前端·c++·人工智能·qt·学习·tcp/ip
wuxianda103015 小时前
Swift 项目用 Xcode 脚手架起步:默认工程结构和依赖组合为什么会被识别成同源
开发语言·xcode·swift·4.3a·appstore审核
ShineWinsu16 小时前
对于Qt:QVBoxLayout常见属性以及方法的解析
开发语言·数据库·c++·qt·gui·客户端·布局管理器