查询命令

query 命令用于检查已安装的 MSVC 工具链组件，并获取路径、环境变量、工具位置和版本信息。

基本用法

# 查询安装的所有信息
msvc-kit query

# 指定安装目录查询
msvc-kit query --dir C:\msvc-kit

选项

组件选择

# 查询所有组件（默认）
msvc-kit query --component all

# 仅查询 MSVC 编译器
msvc-kit query --component msvc

# 仅查询 Windows SDK
msvc-kit query --component sdk

属性选择

可以筛选要获取的信息类型：

# 获取所有信息（默认）
msvc-kit query --property all

# 仅获取安装路径
msvc-kit query --property path

# 获取环境变量
msvc-kit query --property env

# 获取工具可执行文件路径（cl.exe、link.exe 等）
msvc-kit query --property tools

# 获取版本信息
msvc-kit query --property version

# 获取 include 路径
msvc-kit query --property include

# 获取库路径
msvc-kit query --property lib

属性别名：

属性	别名
path	paths、install-path
env	environment、env-vars
tools	tool、executables
version	versions、ver
include	includes、include-paths
lib	libs、lib-paths

架构

# 查询指定架构（默认：x64）
msvc-kit query --arch x64
msvc-kit query --arch x86
msvc-kit query --arch arm64

版本选择

# 查询指定 MSVC 版本
msvc-kit query --msvc-version 14.44

# 查询指定 SDK 版本
msvc-kit query --sdk-version 10.0.26100.0

# 同时指定两者
msvc-kit query --msvc-version 14.44 --sdk-version 10.0.26100.0

输出格式

# 人类可读文本（默认）
msvc-kit query --format text

# JSON 输出（适用于脚本）
msvc-kit query --format json

示例

获取 cl.exe 路径

# 文本输出
msvc-kit query --property tools --format text
# 输出：cl=C:\msvc-kit\VC\Tools\MSVC\14.44.34823\bin\Hostx64\x64\cl.exe

# JSON 输出
msvc-kit query --property tools --format json

获取 CI/CD 环境变量

# JSON 格式便于解析
msvc-kit query --property env --format json

输出：

{
  "INCLUDE": "C:\\msvc-kit\\VC\\Tools\\MSVC\\14.44.34823\\include;...",
  "LIB": "C:\\msvc-kit\\VC\\Tools\\MSVC\\14.44.34823\\lib\\x64;...",
  "PATH": "C:\\msvc-kit\\VC\\Tools\\MSVC\\14.44.34823\\bin\\Hostx64\\x64;...",
  "VCToolsVersion": "14.44.34823",
  "VCINSTALLDIR": "C:\\msvc-kit\\VC",
  "WindowsSdkDir": "C:\\msvc-kit\\Windows Kits\\10",
  "WindowsSDKVersion": "10.0.26100.0\\"
}

获取版本信息

msvc-kit query --property version
# 输出：
# msvc=14.44.34823
# sdk=10.0.26100.0

获取安装路径

msvc-kit query --property path
# 输出：
# install_dir=C:\msvc-kit
# msvc_path=C:\msvc-kit\VC\Tools\MSVC\14.44.34823
# sdk_path=C:\msvc-kit\Windows Kits\10

获取 include 路径用于构建配置

msvc-kit query --property include
# 输出（每行一个路径）：
# C:\msvc-kit\VC\Tools\MSVC\14.44.34823\include
# C:\msvc-kit\Windows Kits\10\Include\10.0.26100.0\ucrt
# C:\msvc-kit\Windows Kits\10\Include\10.0.26100.0\shared
# C:\msvc-kit\Windows Kits\10\Include\10.0.26100.0\um
# C:\msvc-kit\Windows Kits\10\Include\10.0.26100.0\winrt
# C:\msvc-kit\Windows Kits\10\Include\10.0.26100.0\cppwinrt

在脚本中使用

PowerShell：

# 获取 cl.exe 路径
$tools = msvc-kit query --property tools --format json | ConvertFrom-Json
$clPath = $tools.cl
& $clPath /help

# 设置环境变量
$env_vars = msvc-kit query --property env --format json | ConvertFrom-Json
$env_vars.PSObject.Properties | ForEach-Object {
    [Environment]::SetEnvironmentVariable($_.Name, $_.Value, "Process")
}

Bash：

# 获取 MSVC 版本
msvc-kit query --property version --format text | grep msvc | cut -d= -f2

# 导出环境变量
eval $(msvc-kit query --property env --format text | sed 's/^/export /')

CMake：

execute_process(
  COMMAND msvc-kit query --property tools --format json
  OUTPUT_VARIABLE MSVC_TOOLS_JSON
)

库 API

查询功能也可通过 Rust 库 API 使用：

use msvc_kit::query::{QueryOptions, query_installation};
use msvc_kit::Architecture;

let options = QueryOptions::builder()
    .install_dir("C:/msvc-kit")
    .arch(Architecture::X64)
    .build();

let result = query_installation(&options)?;

// 访问工具路径
if let Some(cl) = result.tool_path("cl") {
    println!("cl.exe: {}", cl.display());
}

// 访问环境变量
for (key, value) in &result.env_vars {
    println!("{}={}", key, value);
}

// 访问版本信息
println!("MSVC: {:?}", result.msvc_version());
println!("SDK: {:?}", result.sdk_version());

完整文档请参阅 QueryResult API。

完整参考

msvc-kit query [OPTIONS]

选项：
  -d, --dir <DIR>                安装目录
  -a, --arch <ARCH>              目标架构 [默认：x64]
  -c, --component <COMPONENT>    要查询的组件 (all, msvc, sdk) [默认：all]
  -p, --property <PROPERTY>      要获取的属性 (all, path, env, tools, version, include, lib) [默认：all]
      --msvc-version <VERSION>   指定 MSVC 版本
      --sdk-version <VERSION>    指定 SDK 版本
  -f, --format <FORMAT>          输出格式 (text, json) [默认：text]