通用命令选项
大多数 vcpkg 命令都接受一组控制工具横切方面的通用选项。 并非所有选项都会影响每个命令。 例如，不下载任何文件的命令将不会受到更改下载目录的影响。
选项
--x-asset-sources=<config>
注意
本部分介绍 vcpkg 的一项试验性功能，该功能随时可能会更改或移除。
指定资产缓存的缓存配置。
--binarysource=<config>
添加二进制缓存的源。
此选项可以多次指定；有关多个二进制源如何交互的信息，请参阅二进制缓存文档。
--x-buildtrees-root=<path>
注意
本部分介绍 vcpkg 的一项试验性功能，该功能随时可能会更改或移除。
指定存储中间构建文件（如对象或解压缩的源代码）的临时路径。
默认为 vcpkg 根文件夹下的 buildtrees/。
--x-cmake-configure-debug=<debugger-pipe>[;semicolon;port;list]
注意
本部分介绍 vcpkg 的一项试验性功能，该功能随时可能会更改或移除。
在上游构建系统的 CMakeLists.txt 中启用 CMake 的 --debugger，如在 vcpkg_cmake_configure 内。
<debugger-pipe> 值在 CMake 命令行中作为 --debugger-pipe 传递。
如果有分号分隔的端口列表，则调试程序仅用于该列表中的端口。 否则，该项将用于所有端口。
三元组变量 VCPKG_CMAKE_CONFIGURE_OPTIONS 用于将选项传递给内部 CMake configure 调用。
因此，它不适用于覆盖 VCPKG_CMAKE_CONFIGURE_OPTIONS 的自定义三元组。
手动传递调试选项或改为将选项附加到 VCPKG_CMAKE_CONFIGURE_OPTIONS。
与 --x-cmake-debug 不同，不会有输出指示构建正在等待调试器连接。 输出会在 Configuring <triplet> 处停滞。
尽管所有端口都应在端口文件内部调用 CMake，以从 CMake 工具链获取编译标志。 此命令主要用于实际使用 CMake 作为其构建系统的端口。
--x-cmake-debug=<debugger-pipe>[;semicolon;port;list]
注意
本部分介绍 vcpkg 的一项试验性功能，该功能随时可能会更改或移除。
启用 CMake 的 --debugger，同时运行三元组文件（例如：x64-windows.cmake）或 portfile.cmake 文件等直接调用的 CMake 脚本。
<debugger-pipe> 值在 CMake 命令行中作为 --debugger-pipe 传递。
如果有分号分隔的端口列表，则调试程序仅用于该列表中的端口。 否则，该项将用于所有端口。
注意：如果在 vcpkg 的输出中观察到 Waiting for debugger client to connect...，可以附加调试器，并且执行将暂停，直到调试器已连接。
--downloads-root=<path>
指定保留下载的工具和源代码存档的位置。
默认为 VCPKG_DOWNLOADS 环境变量。 如果该项未设置，则默认为 vcpkg 根文件夹下的 downloads/。
--feature-flags=<flag1>,...
可以将此变量设置为功能标志列表，以选择加入试验性行为。
--host-triplet=<triplet>
指定主机三元组。
默认为 VCPKG_DEFAULT_HOST_TRIPLET 环境变量。 如果该项也未设置，则会根据主机体系结构和操作系统推断该值。
--x-install-root=<path>
注意
本部分介绍 vcpkg 的一项试验性功能，该功能随时可能会更改或移除。
指定布置已安装包的路径。
在 经典模式下，默认为 vcpkg 根文件夹下的 installed/。
在清单模式下，默认为清单文件夹下的 vcpkg_installed/。
--x-manifest-root=<path>
注意
本部分介绍 vcpkg 的一项试验性功能，该功能随时可能会更改或移除。
指定包含 vcpkg.json 的目录。
默认从当前工作目录向上搜索找到最近的 vcpkg.json。
--overlay-ports=<path>
指定包含覆盖端口的目录。
可以多次指定此选项；端口将解析为第一个匹配项。
--overlay-triplets=<path>
指定包含覆盖三元组的目录。
可以多次指定此选项以添加多个目录；三元组将按名称解析为第一个匹配项。
--x-packages-root=<path>
注意
本部分介绍 vcpkg 的一项试验性功能，该功能随时可能会更改或移除。
指定在最终安装之前暂存中间包文件的临时路径。
默认为 vcpkg 根文件夹下的 packages/。
--triplet=<triplet>
指定目标体系结构三元组。
默认为 VCPKG_DEFAULT_TRIPLET 环境变量。 如果该项未设置，则会根据主机体系结构和操作系统推断。
在 Windows 操作系统上，由于遗留原因，体系结构始终推断为 x86。
注意
2023 年 9 月及之后发布的所有版本都将默认使用 Windows 上的主机三元组，而不是 x86-windows。
--vcpkg-root=<path>
指定 vcpkg 根文件夹。
默认为包含 vcpkg 程序的目录。 目录必须是有效的 vcpkg 实例，例如 https://github.com/microsoft/vcpkg 的 git clone。 此选项可用于直接从构建文件夹运行该工具的自定义构建副本。
响应文件 (@<file>)
vcpkg 命令行接受包含换行符分隔的命令行参数的文本文件。
该工具的行为就像将文件中的项目拼接到命令行中代替 @ 引用一样。 响应文件不能包含其他响应文件。
