镜像源配置与优势

清华大学镜像站特点

  • 国内CDN加速
  • 同步官方仓库每日更新
  • 支持HTTP/HTTPS协议

镜像源地址配置

1
2
# 使用PowerShell设置临时镜像源
$env:QT_MIRROR_URL='https://mirrors.tuna.tsinghua.edu.cn/qt/official_releases/qt/'

分步安装流程

步骤1：下载安装器

1
2
# 使用curl下载安装器
curl -o qt-unified-windows.exe https://mirrors.tuna.tsinghua.edu.cn/qt/official_releases/online_installers/qt-unified-windows-x64-online.exe

步骤2：运行安装程序

1
2
# 带镜像源参数启动安装程序
./qt-unified-windows.exe --mirror $env:QT_MIRROR_URL

步骤3：组件选择配置

1
2
3
4
5
6
7
8
9
10
# 必须安装组件
• Qt 5.15.2 主模块
• MSVC 2019 64-bit编译套件
• Qt Creator 4.14开发环境
• Debugging Tools for Windows

# 推荐安装组件
• Qt Charts
• Qt Quick Controls 2
• OpenSSL Toolkit

步骤4：环境变量配置

1
2
3
4
5
# 设置Qt主路径
[Environment]::SetEnvironmentVariable('QT_DIR', 'C:\Qt\5.15.2\msvc2019_64', 'Machine')

# 添加PATH环境变量
$env:Path += ";C:\Qt\Tools\QtCreator\bin;C:\Qt\5.15.2\msvc2019_64\bin"

安装验证

基础验证方法

1
2
3
4
5
# 检查Qt版本
qmake -v

# 验证编译器
cl.exe /?

常见问题解决方案

镜像源失效处理

1
2
3
4
5
# 备用镜像源设置
$env:QT_MIRROR_URL='https://mirrors.aliyun.com/qt/' 

# 离线安装包下载
https://mirrors.tuna.tsinghua.edu.cn/qt/archive/qt/5.15/5.15.2/

依赖缺失修复

1
2
3
4
5
# 安装Visual C++ Redistributable
winget install Microsoft.VCRedist.2019.x64

# 安装Windows SDK
choco install windows-sdk-10.1