CMake预设环境变量仅配置阶段生效，如何传递至构建阶段？

CMake Presets中configurePresets下的environment字段仅作用于CMake配置阶段（即执行cmake --preset时的CMake进程环境），不会自动将这些环境变量写入生成的构建系统文件（如Makefile、Ninja脚本）。当后续执行cmake --build或直接调用构建工具时，构建进程会继承当前shell的环境，而非配置阶段的环境变量，因此链接器/编译器会找不到FOO和BAR。

以下是几种可行的解决方法，可根据实际场景选择：

1. 配置buildPresets定义构建阶段环境变量 #

在CMakePresets.json中新增buildPresets节点，关联对应的配置预设，并设置构建阶段需要的环境变量。之后使用cmake --build --preset命令触发构建，CMake会自动加载预设中的环境变量。

示例配置：

{
  "version": 4,
  "configurePresets": [
    {
      "name": "default",
      "environment": {
        "FOO": "some-value",
        "BAR": "some-other-value"
      }
    }
  ],
  "buildPresets": [
    {
      "name": "default",
      "configurePreset": "default",
      "environment": {
        "FOO": "some-value",
        "BAR": "some-other-value"
      }
    }
  ]
}

使用构建命令：

cmake --build --preset default

2. 在CMakeLists.txt中注入环境变量（适合直接调用构建工具的场景） #

通过CMake代码将环境变量写入生成的构建系统，确保编译/链接进程始终能获取到这些变量。可以结合预设的缓存变量来传递值，避免硬编码。

步骤1：在预设中添加缓存变量 #

修改configurePresets，将环境变量的值同步存入CMake缓存：

{
  "version": 4,
  "configurePresets": [
    {
      "name": "default",
      "environment": {
        "FOO": "some-value",
        "BAR": "some-other-value"
      },
      "cacheVariables": {
        "PROJECT_FOO": "some-value",
        "PROJECT_BAR": "some-other-value"
      }
    }
  ]
}

步骤2：在CMakeLists.txt中设置环境变量 #

在项目根目录的CMakeLists.txt顶部添加以下代码，将缓存变量的值注入到构建环境：

# 从缓存变量中读取值，设置为环境变量
set(ENV{FOO} "${PROJECT_FOO}")
set(ENV{BAR} "${PROJECT_BAR}")

这样无论使用cmake --build还是直接运行make/ninja，编译和链接进程都会带上这些环境变量。

3. 使用CMAKE_BUILD_ENVIRONMENT（CMake 3.21+） #

CMake 3.21及以上版本支持CMAKE_BUILD_ENVIRONMENT变量，可在配置阶段指定构建阶段的环境变量列表，构建系统会在执行每个编译/链接命令时自动注入这些变量。

在项目的CMakeLists.txt中添加：

# 从配置阶段的环境变量中获取值，传递给构建阶段
set(CMAKE_BUILD_ENVIRONMENT
  "FOO=$ENV{FOO}"
  "BAR=$ENV{BAR}"
)

这种方法无需修改构建预设，只需在配置阶段确保环境变量存在（即通过configurePresets设置），CMake会自动将其传递到构建阶段。

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