无法从CMake运行特定Python命令，执行vcvars脚本报错

问题根源 #

CMake的execute_process会继承系统全部环境变量，加上vcvarsx86_amd64.bat追加的大量工具链路径，很容易超出CMD对命令行或环境变量的长度限制；另外，直接拼接复杂命令串时，路径中的空格或特殊字符也会导致CMD解析出现语法错误。

解决方案 #

1. 传递最小化环境变量给Python的subprocess #

不要把完整系统环境变量传给subprocess，只保留VC脚本运行必需的变量，大幅削减PATH长度：

import subprocess
import tempfile
import os

# 构建仅含关键变量的最小环境
minimal_env = {
    "SystemRoot": os.environ.get("SystemRoot"),
    "ProgramFiles": os.environ.get("ProgramFiles"),
    "ProgramFiles(x86)": os.environ.get("ProgramFiles(x86)"),
    # 若有其他必需变量可在此补充
}

vcvars_path = r"C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC\Auxiliary\Build\vcvarsx86_amd64.bat"
temp_file = tempfile.mktemp(suffix=".txt")

# 调用cmd执行脚本并导出PATH
subprocess.run(
    ["cmd.exe", "/c", f'call "{vcvars_path}" && echo %PATH% > "{temp_file}"'],
    env=minimal_env,
    shell=False,
    check=True
)

2. 将逻辑封装到独立BAT脚本 #

把调用vcvars和导出PATH的逻辑写到单独的BAT文件中，避免在命令行拼接过长命令：
创建vcvars_export.bat：

@echo off
call "C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC\Auxiliary\Build\vcvarsx86_amd64.bat"
echo %PATH% > "%~1"

然后Python中调用该脚本：

import subprocess
import tempfile

temp_file = tempfile.mktemp(suffix=".txt")
subprocess.run(
    ["cmd.exe", "/c", f"vcvars_export.bat \"{temp_file}\""],
    check=True
)

3. 直接用CMake内置方式获取VC环境 #

跳过Python中间层，直接在CMake中通过vswhere定位VC工具链并捕获环境变量，更适配CMake的执行环境：

# 定位最新Visual Studio安装路径
execute_process(
    COMMAND vswhere -latest -products * -requires Microsoft.VisualStudio.Component.VC.Tools.x86.x64 -property installationPath
    OUTPUT_VARIABLE VS_INSTALL_PATH
    OUTPUT_STRIP_TRAILING_WHITESPACE
)

set(VCVARS_SCRIPT "${VS_INSTALL_PATH}/VC/Auxiliary/Build/vcvarsx86_amd64.bat")

# 执行vcvars并导出PATH
execute_process(
    COMMAND cmd /c "\"${VCVARS_SCRIPT}\" && echo %PATH%"
    OUTPUT_VARIABLE VC_PATH
    OUTPUT_STRIP_TRAILING_WHITESPACE
)

# 将捕获的PATH设置到CMake环境中
set(ENV{PATH} "${VC_PATH}")

4. 严格处理路径中的空格与特殊字符 #

确保所有含空格的路径都用双引号包裹，并且Python的subprocess使用列表形式传递参数（而非字符串），避免CMD解析时拆分错误：

subprocess.run(
    ["cmd.exe", "/c", "call", "\"" + vcvars_path + "\"", "&&", "echo", "%PATH%", ">", "\"" + temp_file + "\""],
    check=True
)

内容的提问来源于stack exchange，提问作者StNickolay