注意：所有以x開頭的命令或參數目前都只是實驗性質的。
.\vcpkg.exe install {port name}:{triplets} {可選參數}
可選參數
| 命令 |
說明 |
| --dry-run |
不做任何實質上的下載和安裝，僅顯示將要被安裝的庫的名稱和版本 |
| --debug |
顯示詳細的庫的安裝時所需要的環境 |
| --head |
安裝庫的最新的版本 |
| --no-downloads |
不下載新的資源 |
| --only-downloads |
只下載資源包但是不構建 |
| --only-binarycaching |
本次安裝使用二進制緩存文件進行安裝，如果不存在二進制緩存文件，則安裝失敗 |
| --recurse |
允許在安裝過程中刪除軟件包 |
| --keep-going |
當一條安裝命令中包含多個庫時，一個庫安裝失敗時，整條命令不會終止，而是繼續安裝下一個庫 |
| --editable |
使下載下來的庫的原文件可被編輯 |
| --clean-after-build |
在每一個庫構建完成后清理 buildtrees下庫的源文件, packages 和 downloads 下的庫相關的文件 |
| --clean-buildtrees-after-build |
在每一個庫構建完成后清理 buildtrees 文件夾 |
| --clean-packages-after-build |
在每一個庫構建完成后清理 packages 文件夾 |
| --clean-downloads-after-build |
在每一個庫構建完成后清理 downloads 文件夾 |
| --triplet=<t> |
指定目標的triplet，和直接在庫名稱后面以“:xxx”形式添加的triplet功能一致 |
| --host-triplet=<t> |
指定主機的triplet |
| --overlay-ports=<path> |
指定port文件所在用的目錄，詳情參見：Overlay ports |
| --overlay-triplets=<path> |
指定triplets文件所在的路徑，詳情參見：Overlay triplets
|
| --binarysource=<path> |
指定binary cache的路徑，而不是使用默認的 %USERPROFILE%\AppData\Local\vcpkg\archives |
| --downloads-root=<path> |
指定downloads-root的路徑，而不是使用默認的.\vcpkg\downloads |
| --vcpkg-root=<path> |
指定vcpkg-root的路徑，即vcpkg.exe所在的路徑，使用此參數后，vcpkg的其他文件夾，比如buildtrees, installed之類的都會以此路徑為基准進行設置，若此路徑下沒有可用的vcpkg的相關文件，則安裝失敗 |
| --x-write-nuget-packages-config=… |
生成一個自定義名稱的文件，此文件以NuGet packages.config格式記錄了當前安裝的庫的信息。 文件的名稱就是等號后面的參數，比如命令為.\vcpkg.exe install abseil --x-write-nuget-packages-config=123，則在vcpkg.exe同級目錄下生成一個以123為名稱的文件，文件內容如下: <?xml version="1.0" encoding="utf-8"?> <packages> <package id="abseil_x86-windows" version="2021.3.24-vcpkge6b53c1a244a2cb4eb9f049fb4fc04e00d6682579fac1785fda70e541e759870"/> </packages> |
| --x-use-aria2 |
使用aria2來執行下載任務 |
| --x-buildtrees-root=<path> |
指定buildtrees-root的路徑，而不是使用默認的.\vcpkg\buildtrees |
| --x-install-root=<path> |
指定installed-root的路徑，而不是使用默認的.\vcpkg\installed |
| --x-packages-root=<path> |
指定packages-root的路徑，而不是使用默認的.\vcpkg\packages |
| --x-scripts-root=<path> |
指定scripts-root的路徑，而不是使用默認的.\vcpkg\scripts PS F:\vcpkg\vcpkg-feature-bug-test> .\vcpkg.exe install sqlite3 --x-scripts-root=../scripts --debug 目前此功能還沒完成，無法成功安裝port |
| --x-builtin-ports-root=<path> |
指定ports-root的路徑，而不是使用默認的.\vcpkg\ports |
| --x-builtin-registry-versions-dir=<path> |
指定versions-root的路徑，而不是使用默認的.\vcpkg\versions |