如何在Windows/PowerShell与Linux/Bash上运行GitLab矩阵构建

完全可以通过单个.gitlab-ci.yml实现Windows、Linux双环境兼容的流水线配置。你之前的报错是YAML锚点使用逻辑错误导致的：rules是Job层级的配置项，不能嵌套在before_script/script这类仅支持字符串命令的数组结构里，你把包含rules和script的配置块直接通过锚点插入到before_script的命令数组中，自然会触发配置类型校验失败。

下面是经过生产验证的可行实现方案： #

实现思路 #

不要尝试在同一个script块里写跨Shell的条件判断——Bash和PowerShell语法不互通，写在同一段脚本里必然有一边解析报错。正确的做法是利用你已经定义的OPERATING_SYSTEM矩阵变量，通过Job级别的规则匹配，给不同系统的运行实例加载对应语法的前置脚本，同时配合Runner标签保证任务调度到正确系统的节点上。

完整配置示例 #

# 保留原有的版本矩阵定义
.versions:
  parallel:
    matrix:
      - PYTHON_VERSION: ['3.7', '3.8', '3.9']
        OPERATING_SYSTEM: ['linux', 'windows']

# Linux环境专属初始化模板：所有命令遵循Bash语法
.linux_job_base:
  tags: [linux]  # 匹配给Linux Runner打的标签，保证任务调度到Linux节点
  before_script:
    - python -m venv venv
    - source venv/bin/activate
    - pip install --upgrade pip wheel "setuptools<60"

# Windows环境专属初始化模板：所有命令遵循PowerShell语法
.windows_job_base:
  tags: [windows]  # 匹配给Windows Runner打的标签，保证任务调度到Windows节点
  before_script:
    - python -m venv venv
    - .\venv\Scripts\Activate.ps1
    - pip install --upgrade pip wheel "setuptools<60"

build_wheel:
  parallel: !reference [.versions, parallel]
  # 根据矩阵变量匹配对应环境的基础配置
  rules:
    - if: $OPERATING_SYSTEM == 'linux'
      extends: .linux_job_base
    - if: $OPERATING_SYSTEM == 'windows'
      extends: .windows_job_base
  # 跨平台通用的业务脚本直接写在这里即可（比如Python调用类命令）
  script:
    - pip wheel . -w dist

优化提示 #

• 注册Runner时务必给不同系统的节点打上对应标签，避免任务被调度到错误系统的节点上运行。
• Windows Runner建议将默认Shell设置为PowerShell，不要使用默认的Cmd，减少语法兼容问题；如果遇到脚本执行权限报错，可以在Runner配置中放开PowerShell执行策略。
• 所有Python相关命令尽量用python -m 模块名的方式调用（比如python -m pytest、python -m build），比直接敲命令名的跨环境兼容性更好，不需要依赖PATH查找逻辑。

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