一般命令選項
大部分的 vcpkg 命令都接受一組可控制工具跨領域層面的常見選項。 並非所有選項都會影響每個命令。 例如，不會下載任何檔案的命令將會因為變更下載目錄而受到影響。
選項。
--x-asset-sources=<config>
注意
本節涵蓋 vcpkg 的實驗功能，隨時可能會變更或移除。
指定資產快取的 快取組態。
--binarysource=<config>
新增二進位快取的來源。
這個選項可以指定多次;如需多個二進位來源的互動方式，請參閱二進位快取檔。
--x-buildtrees-root=<path>
注意
本節涵蓋 vcpkg 的實驗功能，隨時可能會變更或移除。
指定儲存中繼組建檔案的暫存路徑，例如物件或解壓縮的原始程式碼。
預設為 buildtrees/ vcpkg 根資料夾底下的 。
--classic
即使偵測到指令清單檔，仍會強制傳統模式。
--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>
指定重 迭埠或本身重疊埠的子目錄。 如果 <path> 是包含 CONTROL 或vcpkg.json的目錄，則會將其視為重迭埠目錄，且子目錄不會被視為額外的重疊埠。
這個選項可以指定多次;埠會解析為第一個相符專案。
--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 命令行接受包含換行分隔命令行參數的文字檔。
此工具的作用就像檔案中的專案已接合到命令行，以取代 @ 參考。 回應檔不能包含其他回應檔。
