vcpkg 常用命令 - Install
注意：所有以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 |