使用命令行界面获取和安装 Qt
使用Qt Online Installer 和Qt Maintenance Tool 的命令行界面安装、卸载、更新和搜索组件。
命令行界面支持交互式和非交互式使用（无人值守使用）。以下主题提供了如何使用命令行界面的示例和信息：
- 使用命令行界面下载Qt Online Installer
- 安装组件名称
- 无用户交互安装
- 通过用户交互安装
- 卸载软件包
- 列出已安装的软件包
- 检查更新
- 更新软件包
- 常用命令
- 为开源选择镜像
- 命令行界面使用摘要
使用命令行界面下载Qt Online Installer
你可以在命令行界面使用curl 命令下载Qt Online Installer 。要查看适用于不同平台的所有Qt Online Installer 软件包，请访问Qt Online Installer 官方发布。
要下载与远程文件同名的特定Qt Online Installer 软件包，请使用-O （大写 "O"）选项。
下面的示例命令下载的是qt-online-installer-linux-x64-online.run 软件包：
curl -O https://download.qt.io/official_releases/online_installers/qt-online-installer-linux-x64-online.run
安装组件名称
使用别名软件包快速安装
你可以使用别名包来安装最常见的配置，而不用搜索特定的安装包名称。别名包是包含实际软件包的快捷方式，可让安装体验更轻松。
列出现有的别名包
要列出现有的别名软件包，请在命令行界面上使用以下命令。
使用Qt Online Installer ：
<installer executable> search
有关不同平台的 Qt Online Installer不同平台的可执行文件，请参阅 "通过用户交互安装"。
使用Qt Maintenance Tool ：
<maintenancetool executable> search
有关不同平台的 Qt Maintenance Tool不同平台的可执行文件，请参阅 "通过用户交互安装"。
别名软件包的内容
下表列出了别名软件包的内容。
注意： 下面列出的别名包示例中使用的是 Qt 6.9.1 版本。请务必记住使用与您正在运行的 Qt 版本相匹配的软件包。
| 别名软件包名称 | Qt Online Installer (软件包内容） |
|---|---|
| qt6.9.1-essentials |
|
| qt6.9.1-essentials-dev |
|
| qt6.9.1-full | |
| qt6.9.1-full-dev | |
| qt6.9.1-full-dbg | |
| qt6.9.1-sdk |
|
Qt Online Installer 命令示例
# Windows: new installation with Qt Online Installer
qt-unified-windows-x64-[Qt Online Installer version]-online.exe install qt6.9.1-sdk
# macOS: new installation with Qt Online Installer
hdiutil attach qt-unified-macOS-x64-[Qt Online Installer version]-online.dmg
/Volumes/qt-unified-macOS-x64-[Qt Online Installer version]-online/qt-unified-macOS-x64-[Qt Online Installer version]-online.app/Contents/MacOS/qt-unified-macOS-x64-[Qt Online Installer version]-online install qt6.9.1-sdk
hdiutil detach /Volumes/qt-unified-macOS-x64-[Qt Online Installer version]-online
# Linux: new installation with Qt Online Installer
qt-unified-linux-x64-[Qt Online Installer version]-online.run install qt6.9.1-sdkWindows 的别名包选项
注意： 本节信息适用于 Qt 6.8、Qt 6.9 和 Qt 6.10 版本。
ARM64 上的 Windows
由于其他 Qt 二进制包不适用于 Windows on Arm (WoA)，因此只安装 MSVC 二进制包 (msvc2022-arm64)。
x86_64 上的 Windows
默认情况下，只安装 MinGW 二进制文件。
不过，在x86_64 上的 Windows中，您还可以安装以下工具链的二进制包。
- llvm-mingw
- msvc2022
- msvc2022-arm64（用于交叉编译）
例如，使用qt6.9.1-essentials别名包会安装带有默认 MinGW 二进制文件的软件包。
要获取Qt essentials 包的内容，例如 MSVC 2022 二进制文件，请使用相应的qt6.9.1-msvc2022-essentials别名包。
列出非别名包
要列出非别名软件包，请在命令行界面上使用以下命令。
使用Qt Online Installer ：
<installer executable> search --type package
有关不同平台的 Qt Online Installer不同平台的可执行文件，请参阅通过用户交互安装。
使用Qt Maintenance Tool ：
<maintenancetool executable> search --type package
有关不同平台的 Qt Maintenance Tool不同平台的可执行文件，请参阅通过用户交互安装。
高级搜索特定安装软件包
使用search 命令和正则表达式搜索可用软件包： search <regexp>.可以使用 --filter-packages <regexp>.例如，使用显示名称信息过滤有助于搜索。
例如，以下命令可查找 Qt 6.9.1 的所有 MSVC 2022 软件包：
search .*691.*msvc2022
如果按如下方式过滤搜索结果，也会得到相同的结果：
search --filter-packages DisplayName=MSVC 2022,Version=6.9.1
结果会得到以下软件包：
<availablepackages>
<package name="qt.qt6.691.win64_msvc2022_64" displayname="MSVC 2022 64-bit" version="6.9.1.-0-<timestamp>"/>
<package name="qt.qt6.691.win64_msvc2022_arm64" displayname="MSVC 2022 ARM64" version="6.9.1.-0-<timestamp>"/>
</availablepackages>在搜索某些软件包提供的所有 Qt 版本时，也可以使用过滤功能。例如，搜索为 Qt 版本提供的所有Qt Charts 软件包：
search --filter-packages DisplayName=charts
搜索结果如下：
<availablepackages>
<package name="qt.qt5.5125.qtcharts" displayname="Qt Charts" version="5.12.5-0-<timestamp>"/>
<package name="qt.qt6.641.addons.qtcharts" displayname="Qt Charts" version="6.4.1-0-<timestamp>"/>
<package name="qt.qt5.5123.qtcharts" displayname="Qt Charts" version="5.12.3-0-<timestamp>"/>无需用户交互即可安装
默认情况下，Qt Online Installer 或Qt Maintenance Tool 可能会在安装过程中要求提供其他信息，这需要用户注意。通过命令行界面进行无人值守的使用是可行的，方法是事先提供所有要求的信息，并提供适当的选项。
新安装Qt Online Installer
您可以通过命令行界面进行新安装，无需用户交互，具体方法如下：
- 定义 Qt Online Installer可执行文件。
- 用
--root. - 使用
install <list of packages>命令，并使用无人值守选项。请参阅 "无人值守使用选项"中的完整选项列表。
以下示例演示了如何使用Qt Online Installer 安装 Windows、macOS 和 Linux 下的 Qt 6.9.1 二进制文件。无人值守命令会自动接受许可证 (--accept-licenses) ，用默认答案 (--default-answer) ，并跳过请求许可以继续执行 (--confirm-command):
# Windows: new installation with Qt Online Installer
qt-unified-windows-x64-[Qt Online Installer version]-online.exe --root C:\Users\[username]\installation_dir --accept-licenses --default-answer --confirm-command install qt.qt6.691.win64_msvc2022_64
# macOS: new installation with Qt Online Installer
qt-unified-macOS-x64-[Qt Online Installer version]-online.dmg --root /home/<username>/installation_dir --accept-licenses --default-answer --confirm-command install qt.qt6.691.clang_644
# linux: new installation with Qt Online Installer
qt-unified-linux-x64-[Qt Online Installer version]-online.run --root /home/<username>/installation_dir --accept-licenses --default-answer --confirm-command install qt.qt6.691.gcc_64无人值守使用选项》列出了无人值守使用的所有可用选项。
更新安装Qt Maintenance Tool
您可以从命令行界面更新现有安装，无需用户交互，具体方法如下：
- 定义 Qt Maintenance Tool可执行文件。
- 使用
install <list of packages>选项进行无人值守使用。请参阅 "无人值守使用选项"中的完整选项列表。
下面的示例演示了如何将带有Qt Maintenance Tool 的 Qt 6.9.1 二进制文件添加到 Windows、macOS 和 Linux 上的 exsting 安装中。无人值守命令会自动接受许可证 (--accept-licenses) ，用默认答案 (--default-answer) ，并跳过请求许可以继续执行 (--confirm-command):
# Windows: update installation with Qt Maintenance Tool
MaintenanceTool.exe --accept-licenses --default-answer --confirm-command install qt.qt6.691.win64_msvc2022_64
# macOS: update installation with Qt Maintenance Tool
MaintenanceTool.app/Contents/MacOS/MaintenanceTool --accept-licenses --default-answer --confirm-command install qt.qt6.691.clang_64
# linux: update installation with Qt Maintenance Tool
MaintenanceTool.run --accept-licenses --default-answer --confirm-command install qt.qt6.691.gcc_64无人值守使用的选项
下表列出了无人值守命令行使用的所有选项：
| 无人值守使用选项 | 说明 |
|---|---|
--accept-licenses | 自动接受所有许可协议。 |
--accept-obligations | 在开源安装中，无需用户输入即可接受 Qt 开源使用义务。 |
--default-answer | 以默认答案回答所有信息查询。 |
--auto-answer <identifier=value> | 如果你想对某些查询给出不同的答案，可以使用该选项。例如，--auto-answer telemetry-question=Yes,AssociateCommonFiletypes=Yes 。有关 --auto-answer 的信息标识符，请参见信息标识符中的所有信息标识符。 |
--accept-messages | 接受所有信息查询。 |
--reject-messages | 拒绝所有信息查询。 |
--confirm-command | 默认情况下，Qt Online Installer 和Qt Maintenance Tool 会打印受该选项影响的组件摘要。然后它们会询问是否允许继续运行，以防止意外更改。该选项会跳过继续操作的许可请求。 |
--email <your_email> | 提供从命令行登录时的电子邮件。更多信息，请参阅提供登录信息。 |
--pw <your_pw> | 从命令行登录时提供密码。更多信息，请参阅提供登录信息。 |
--file-query <identifier=value> | 有时，Qt Online Installer 会询问文件或文件夹的位置。您可以使用--file-query <identifier=value> 提供位置。例如，--file-query PathForSDP7=<path_to_sdp> 。标识符会在实际问题和信息类型之前打印到命令行中。您可以从这里获取标识符。 |
用于 --auto-answer 的信息标识符
使用--auto-answer 选项可为某些查询提供答案。下表列出了用于--auto-answer 的已知标识符和值：
| 标识符 | 值 | 默认值 |
|---|---|---|
| 操作不存在错误 | 终止，忽略 | 忽略 |
| 覆盖目标目录 | 是，否 | 是，否 |
| 停止更新进程 | 重试、忽略、取消 | 取消 |
| 安装错误与取消 | 重试、忽略、取消 | 取消 |
| 安装错误忽略 | 重试、忽略 | 忽略 |
| 关联常用文件类型 | 是，否 | 是，否 |
| 遥测问题 | 是, 否 | 是，否 |
提供登录信息
Qt Online Installer 和 有强制登录功能。如果缓存中有Qt Maintenance Tool qtaccount.ini文件，强制登录会使用该文件中的信息。qtaccount.ini文件如下：
| 主机 | qtaccount.ini 所在位置 |
|---|---|
| Windows | C:\Users\<username>\AppData\Roaming\Qt |
| MacOS | /Users/<username>/Library/Application Support/Qt/qtaccount.ini |
| Linux | /home/<username>/.local/share/Qt/qtaccount.ini |
也可选择从命令行登录，使用电子邮件和密码开关：--email <your_email> 和--pw <your_pw> 。
或者，你也可以将 jwt 令牌保存到环境变量QT_INSTALLER_JWT_TOKEN 中。你可以在qtaccount.ini文件中找到令牌。
通过用户交互安装
你可以使用命令行界面与用户交互，方法如下：
- 定义可执行文件：
- Qt Online Installer如果需要进行新安装。
- Qt Maintenance Tool如果需要更新现有安装。
- 进行新安装时，用
--root - 使用
install <list of packages>来安装列出的软件包。
以下示例演示了如何通过Qt Online Installer 为 Windows、macOS 和 Linux 创建新的 Qt 6.9.1 二进制安装：
# Windows: new installation with user interaction qt-unified-windows-x64-[Qt Online Installer version]-online.exe --root C:\Users\[username]\installation_dir install qt.qt6.691.win64_msvc2022_64 # macOS: new installation with user interaction qt-unified-macOS-x64-[Qt Online Installer version]-online.dmg --root /home/<username>/installation_dir install qt.qt6.691.clang_64 # linux: new installation with user interaction qt-unified-linux-x64-[Qt Online Installer version]-online.run --root /home/<username>/installation_dir install qt.qt6.691.gcc_64
以下示例演示了如何通过Qt Maintenance Tool 安装 Qt 6.9.1 二进制文件来更新现有安装：
# Windows: update installation with Qt Maintenance Tool
MaintenanceTool.exe install qt.qt6.691.win64_msvc2022_64
# macOS: update installation with Qt Maintenance Tool
MaintenanceTool.dmg install qt.qt6.691.clang_64
# Linux: update installation with Qt Maintenance Tool
MaintenanceTool.run install qt.qt6.691.gcc_64卸载软件包
命令行界面提供了两种卸载软件包的命令：
- 命令卸载列出的软件包。
remove <list of packages>命令卸载列出的软件包。 - 命令卸载列出的软件包。
purge命令卸载所有已安装的软件包。
这两个命令都应与Qt Maintenance Tool 一起使用。
默认情况下，Qt Maintenance Tool 打印受命令影响的组件摘要。然后工具会询问是否允许继续操作，以防止意外更改。使用 --confirm-command跳过继续执行的请求。
以下示例无需用户交互即可卸载 Qt 6.9.1 二进制文件：
# windows MaintenanceTool.exe --confirm-command remove qt.qt6.691.win64_msvc2022_64 # macOS MaintenanceTool.dmg --confirm-command remove install qt.qt6.691.clang_64 # linux MaintenanceTool.run --confirm-command remove qt.qt6.691.gcc_64
以下示例卸载所有软件包，并请求允许继续执行操作：
# Windows MaintenanceTool.exe purge # macOS MaintenanceTool.dmg purge # Linux MaintenanceTool.run purge
列出已安装的软件包
该 list命令列出已安装的所有软件包。使用Qt Maintenance Tool 命令，如下所示：
# Windows MaintenanceTool.exe list # macOS MaintenanceTool.dmg list # Linux MaintenanceTool.run list
检查更新
该 check-updates命令检查已安装软件包的可用更新。与Qt Maintenance Tool 一起使用该命令，如下所示：
# Windows MaintenanceTool.exe check-updates # macOS MaintenanceTool.dmg check-updates # Linux MaintenanceTool.run check-updates
更新软件包
命令更新已安装的软件包。 update命令更新已安装的软件包。与Qt Maintenance Tool 一起使用该命令，如下所示：
# windows MaintenanceTool.exe update # macOS MaintenanceTool.dmg update # linux MaintenanceTool.run update
常用命令
使用命令 <installer_executable> --help研究可用的命令和选项。常用命令如下：
| 命令 | 使用方法 |
|---|---|
in,install <pkg ...> | 安装作为参数给出的软件包。如果没有给出任何软件包，则安装默认软件包集。 |
rm,remove <pkg ...> | 卸载选中的软件包及其子组件。 |
ch,check-updates | 显示Qt Maintenance Tool 上的可用更新信息。 |
up,update <pkg ...> | 更新作为参数给出的软件包。如果没有给出软件包，则安装所有可用的更新。 |
se,search <regexp> | 搜索可用软件包。如果没有给出搜索模式，则显示所有可用软件包。可以使用--filter-packages 选项为搜索操作指定额外的筛选器。请参阅Qt Installer Framework 手册中的选项摘要。 |
Qt Installer Framework 手册》提供了有关命令和选项的更多信息。
为开源选择镜像
Qt Online Installer 有一个为开源元数据和下载选择镜像的选项。使用 --mirror选项设置镜像。
例如，使用--mirror 如下：
installer(.exe) --mirror http://www.nic.funet.fi/pub/mirrors/download.qt-project.org installer(.exe) --mirror http://ftp2.nluug.nl/languages/qt maintenancetool(.exe) --mirror http://qt.mirror.constant.com
如示例所示，不要使用完整路径，而应使用"/online "前的路径（末尾不使用斜线）。
您可以从https://download.qt.io/online/qtsdkrepository/windows_x86/root/qt/Updates.xml.mirrorlist 找到可用的镜像。
命令行界面使用摘要
Qt Installer Framework 手册》提供了有关命令行界面的更多详细信息：
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
