一般命令選項

大部分的 vcpkg 命令都接受一組可控制工具跨領域層面的常見選項。 並非所有選項都會影響每個命令。 例如，不會下載任何檔案的命令將會因為變更下載目錄而受到影響。

選項。

--x-asset-sources=<config>

注意

本節涵蓋 vcpkg 的實驗功能，隨時可能會變更或移除。

指定資產快取的 快取組態。

--binarysource=<config>

新增二進位快取的來源。

這個選項可以指定多次;如需多個二進位來源的互動方式，請參閱二進位快取檔。

--x-buildtrees-root=<path>

注意

本節涵蓋 vcpkg 的實驗功能，隨時可能會變更或移除。

指定儲存中繼組建檔案的暫存路徑，例如物件或解壓縮的原始程式碼。

預設為 buildtrees/ vcpkg 根資料夾底下的 。

--x-cmake-configure-debug=<debugger-pipe>[;semicolon;port;list]

注意

本節涵蓋 vcpkg 的實驗功能，隨時可能會變更或移除。

在上游組建系統CMakeLists.txt內啟用 CMake--debugger，例如 在 內vcpkg_cmake_configure。

這個值 <debugger-pipe> 會在 CMake 命令列上傳遞為 --debugger-pipe 。

如果有分號分隔的埠清單，調試程式只會用於該清單中的埠。 否則，它會用於所有埠。

triplet 變數 VCPKG_CMAKE_CONFIGURE_OPTIONS 可用來將選項傳遞至內部 CMake 設定呼叫。 因此，它不適用於覆寫 VCPKG_CMAKE_CONFIGURE_OPTIONS的自定義三元組。 手動傳遞偵錯選項，或改為將選項附加至 VCPKG_CMAKE_CONFIGURE_OPTIONS 。

不同於 --x-cmake-debug 沒有輸出，表示組建正在等候調試程式連線。 輸出只會在停止 Configuring <triplet>。

雖然所有埠都應該在 portfile 內呼叫 CMake，以從 CMake 工具鏈取得編譯旗標。 此命令主要適用於實際使用 CMake 作為建置系統的埠。

--x-cmake-debug=<debugger-pipe>[;semicolon;port;list]

注意

本節涵蓋 vcpkg 的實驗功能，隨時可能會變更或移除。

啟用 CMake 在執行 --debugger 直接叫用的 CMake 腳稿時，例如三重檔案（例如： x64-windows.cmake） 或 portfile.cmake 檔案。

這個值 <debugger-pipe> 會在 CMake 命令列上傳遞為 --debugger-pipe 。

如果有分號分隔的埠清單，調試程式只會用於該清單中的埠。 否則，它會用於所有埠。

注意：如果 Waiting for debugger client to connect... 可以在 vcpkg 的輸出中觀察到調試程式，並停止執行，直到調試程式連線為止，就可以附加調試程式。

--downloads-root=<path>

指定應保留下載的工具和原始程式碼封存的位置。

默認為 VCPKG_DOWNLOADS 環境變數。 如果這是未設定的，則預設為 downloads/ vcpkg 根資料夾底下。

--feature-flags=<flag1>,...

此變數可以設定為功能旗標清單，以選擇加入實驗行為。

--host-triplet=<triplet>

指定主機三重。

默認為 VCPKG_DEFAULT_HOST_TRIPLET 環境變數。 如果這也是未設定的，則會根據主機架構和操作系統來推斷值。

--x-install-root=<path>

注意

本節涵蓋 vcpkg 的實驗功能，隨時可能會變更或移除。

指定要設定已安裝套件的路徑。

在 傳統模式中，預設為 installed/ vcpkg 根資料夾底下。

在 指令清單模式中，預設為 vcpkg_installed/ 指令清單資料夾底下的 。

--x-manifest-root=<path>

注意

本節涵蓋 vcpkg 的實驗功能，隨時可能會變更或移除。

指定包含 vcpkg.json的目錄。

預設會從目前的工作目錄向上搜尋最 vcpkg.json接近 的 。

--overlay-ports=<path>

指定包含重 迭埠的目錄。

這個選項可以指定多次;埠會解析為第一個相符專案。

--overlay-triplets=<path>

指定包含重疊三重疊 的目錄。

您可以指定此選項多次以新增多個目錄;三胞胎會依名稱解析為第一個相符專案。

--x-packages-root=<path>

注意

本節涵蓋 vcpkg 的實驗功能，隨時可能會變更或移除。

指定暫存中繼套件檔案的暫存路徑，再進行最終安裝。

預設為 packages/ vcpkg 根資料夾底下的 。

--triplet=<triplet>

指定目標架構三重。

默認為 VCPKG_DEFAULT_TRIPLET 環境變數。 如果這是未設定的，則會根據主機架構和操作系統來推斷。

在 Windows 作業系統上，架構一律會因為舊版原因而推斷為 x86。

注意

在 2023 年 9 月之後建立的所有版本都會預設為 Windows 上的主機三重專案，而不是 x86-windows。

--vcpkg-root=<path>

指定 vcpkg 根資料夾。

預設為包含 vcpkg 程式的目錄。 目錄必須是有效的 vcpkg 實例，例如 git clone 的 https://github.com/microsoft/vcpkg。 這個選項可用來直接從組建資料夾執行工具的自訂建置複本。

回應檔 （@<file>）

vcpkg 命令行接受包含換行分隔命令行參數的文字檔。

此工具的作用就像檔案中的專案已接合到命令行，以取代 @ 參考。 回應檔不能包含其他回應檔。