环境变量

项目
02/02/2024

VCPKG_DOWNLOADS

可将此环境变量设置为现有目录（而不是内部 downloads/ 目录）用于共享下载。应始终设置为绝对路径。

VCPKG_FEATURE_FLAGS

可将此环境变量设置为 vcpkg 中 off-by-default 功能以逗号分隔的列表。这些功能可能会更改，恕不另行通知，应视为非常不稳定。

目前没有 off-by-default 功能标志。

编辑器

可将此环境变量设置为可供 vcpkg edit 使用的可执行文件的完整路径。请参阅 vcpkg help edit，了解特定于命令的帮助。

VCPKG_ROOT

可将此环境变量设置为要用作 vcpkg 实例的根的目录。仅当 vcpkg 可执行文件不在有效根中，且没有使用命令行开关 --vcpkg-root 时，才使用此环境变量。

VCPKG_VISUAL_STUDIO_PATH

可将此环境变量设置为计算机上 Visual Studio 实例的完整路径。如果三联密码未通过 VCPKG_VISUAL_STUDIO_PATH 三联密码设置代替它，则会使用此 Visual Studio 实例。

示例：D:\2017

VCPKG_DEFAULT_TRIPLET

可将此环境变量设置为将会供命令行中不符合条件的三联密码参考使用的三联密码名称。

VCPKG_DEFAULT_HOST_TRIPLET

可将此环境变量设置为将会供命令行中不符合条件的主机端口参考，以及依赖项列表中的所有端口参考使用的三联密码名称。有关详细信息，请参阅主机-依赖项文档。

VCPKG_OVERLAY_PORTS

此环境变量在命令行上列出的那些路径之后添加被认为是其他的覆盖端口路径。使用平台依赖项 PATH 分隔符（Windows 为 ; | 其他为 :）列出覆盖的路径

示例 (Windows)：C:\custom-ports\boost;C:\custom-ports\sqlite3

VCPKG_OVERLAY_TRIPLETS

此环境变量允许用户添加用于搜索三联密码的目录。

使用平台依赖项 PATH 分隔符（Windows 为 ;，其他为 :）列出覆盖的路径

请参阅示例：覆盖三联密码，查看示例。

VCPKG_FORCE_SYSTEM_BINARIES

如果设置此环境变量，则会抑制下载 CMake 和 Ninja，并强制使用系统二进制。

VCPKG_FORCE_DOWNLOADED_BINARIES

如果设置此环境变量，将忽略系统二进制的用法，并且将始终下载并使用 vcpkg 定义的版本。

VCPKG_KEEP_ENV_VARS

可将此环境变量设置为由 ; 分隔的环境变量列表，将会传播到版本环境。

包 ABI 中不会跟踪保留的变量的值，且该值发生变化时不会导致重新生成。请参阅 VCPKG_ENV_PASSTHROUGH，了解在应导致重新生成的环境变量中传递。

示例： FOO_SDK_DIR;BAR_SDK_DIR

VCPKG_MAX_CONCURRENCY

此环境变量限制基础生成系统使用的并发量。如果未指定，则默认为逻辑核心 + 1。

VCPKG_DEFAULT_BINARY_CACHE

此环境变量将重定向默认位置以存储二进制包。有关详细信息，请参阅二进制缓存。

VCPKG_BINARY_SOURCES

此环境变量添加或删除二进制源。有关详细信息，请参阅二进制缓存。

VCPKG_NUGET_REPOSITORY

此环境变量更改生成的 NuGet 包的元数据。有关详细信息，请参阅二进制缓存。

VCPKG_USE_NUGET_CACHE

此环境变量允许为每个基于 nuget 的二进制源使用 NuGet 的缓存。有关详细信息，请参阅二进制缓存。

X_VCPKG_NUGET_PREFIX

向从 NuGet 二进制缓存推送或恢复的所有二进制包的名称添加前缀。

例如，如果 X_VCPKG_NUGET_PREFIX 设置为 vcpkg_demo-，zlib_x64-windows.1.2.13-vcpkg8918746ce8b60474e5ebe68e53355fa70eb05119be913a1d1dc0b930b3b7b6e8.nupkg 二进制包会变为 vcpkg_demo-zlib_x64-windows.1.2.13-vcpkg8918746ce8b60474e5ebe68e53355fa70eb05119be913a1d1dc0b930b3b7b6e8.nupkg。

X_VCPKG_ASSET_SOURCES

注意

本部分介绍 vcpkg 的实验性功能，此类功能随时可能会更改或删除。

此环境变量允许对所有 SHA512 标记的资产使用专用镜像。有关详细信息，请参阅资产缓存。

VCPKG_NO_CI

设置 VCPKG_NO_CI 会禁用 vcpkg 的 CI 环境检测启发式。

VSLANG

此环境变量设置 vcpkg 使用哪种语言来显示消息。应将此环境变量设置为 14 种支持的 LCID（区域设置标识符，4 位值应对于一种语言）中的一种。

例如：1033 对应于英语（美国）语言。请参阅本地化，查看支持的 LCID 的完整列表。

ACTIONS_CACHE_URL

此环境变量是 GitHub Actions 缓存的 URL。有关详细信息，请参阅二进制缓存。

ACTIONS_RUNTIME_TOKEN

此环境变量是 GitHub Actions 缓存的访问令牌。有关详细信息，请参阅二进制缓存。

通过