環境變數

VCPKG_DOWNLOADS

此環境變數可以設定為現有的目錄，以用於儲存下載，而不是內部 downloads/ 目錄。 它應該一律設定為絕對路徑。

VCPKG_FEATURE_FLAGS

此環境變數可以設定為 vcpkg 中以逗號分隔的 off-by-default 功能清單。 這些功能可能會變更而不通知，且應視為高度不穩定。

目前沒有預設功能旗標。

編輯器

此環境變數可以設定為要用於 vcpkg edit之可執行檔的完整路徑。 如需命令特定說明，請參閱 vcpkg help edit 。

VCPKG_ROOT

此環境變數可以設定為目錄，以做為 vcpkg 實例的根目錄。 只有當 vcpkg 可執行檔不在有效的根目錄內，而且命令行參數未使用時，才會使用這個值 --vcpkg-root 。

VCPKG_VISUAL_STUDIO_PATH

此環境變數可以設定為計算機上Visual Studio實例的完整路徑。 如果三元組未透過 VCPKG_VISUAL_STUDIO_PATH triplet 設定覆寫它，將會使用此 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

此環境變數可以設定為環境變數清單，並以 分隔 ;，這會傳播至建置環境。

保留變數的值將不會在套件 ABIS 中追蹤，也不會在變更時造成重建。 若要傳入應該在變更時重建的環境變數，請參閱 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 快取的存取令牌。 如需詳細資訊，請參閱 二進位快取 。