如何在GitLab CI中跨Bash/PowerShell提取CMake通用命令行选项？

核心问题原因 #

Bash会自动将空格分隔的变量内容拆分为多个参数，但PowerShell不会——它会把整个变量值当作单个参数传递给CMake，导致选项解析失败。

简单可行的解决方案 #

方案1：CI脚本分段适配不同Shell #

在CI配置中通过条件判断，针对不同Runner的Shell类型处理变量展开：

variables:
  CMAKE_COMMON_OPTIONS: "-DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_STANDARD=17"

.build_job:
  script:
    - |
      if [ "$CI_RUNNER_EXECUTABLE_ARCH" = "windows" ]; then
        # PowerShell下用Invoke-Expression拆分参数
        Invoke-Expression "cmake .. $CMAKE_COMMON_OPTIONS"
      else
        # Bash下直接展开变量
        cmake .. $CMAKE_COMMON_OPTIONS
      fi

linux_build:
  extends: .build_job
  tags:
    - linux

windows_build:
  extends: .build_job
  tags:
    - windows

方案2：将选项定义为YAML数组 #

把通用选项拆分为数组，在不同Shell中分别处理数组展开逻辑：

variables:
  CMAKE_COMMON_OPTIONS:
    - "-DCMAKE_BUILD_TYPE=Release"
    - "-DCMAKE_CXX_STANDARD=17"

.build_job:
  script:
    - |
      if [ "$CI_RUNNER_EXECUTABLE_ARCH" = "windows" ]; then
        # PowerShell中展开数组
        cmake .. $env:CMAKE_COMMON_OPTIONS
      else
        # Bash中展开数组
        cmake .. "${CMAKE_COMMON_OPTIONS[@]}"
      fi

这种方式更严谨，能避免空格转义相关的问题，适合包含复杂参数的场景。

方案3：使用CMake预设文件（推荐） #

将通用构建选项写入CMakePresets.json，CI脚本只需指定预设名称，彻底规避Shell差异：

// CMakePresets.json
{
  "version": 3,
  "configurePresets": [
    {
      "name": "common",
      "hidden": true,
      "cacheVariables": {
        "CMAKE_BUILD_TYPE": "Release",
        "CMAKE_CXX_STANDARD": "17"
      }
    },
    {
      "name": "linux-build",
      "inherits": "common",
      "generator": "Unix Makefiles"
    },
    {
      "name": "windows-build",
      "inherits": "common",
      "generator": "Ninja"
    }
  ]
}

对应的CI配置可简化为：

.build_job:
  script:
    - cmake --preset $CI_JOB_NAME

linux-build:
  extends: .build_job
  tags:
    - linux

windows-build:
  extends: .build_job
  tags:
    - windows

该方案将构建配置与CI脚本彻底分离，同时支持本地开发复用预设，是最干净的实现方式。

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