如何用GitLab Shell执行器（PowerShell）运行MSBuild构建VS解决方案

错误原因 #

1. 带空格的可执行文件路径未正确引用：$msbuild变量存储的MSBuild路径包含空格（C:\Program Files (x86)\...），PowerShell直接调用未加引号的带空格路径会被拆分为多个参数，触发语法错误。
2. 变量与路径分隔符的解析冲突：$env:CI_PROJECT_DIR\build\myproject.sln中，PowerShell会将$env:CI_PROJECT_DIR\误认为一个完整变量名，无法正确识别后续的路径部分。

修正后的CI脚本 #

将原script中的MSBuild调用行替换为以下任意一种写法：

方法1：使用Join-Path拼接路径（推荐，避免路径分隔符问题） #

script:
  - mkdir build
  - cmake.exe -Bbuild -DBUILD_DEPS=ON
  - echo $env:PATH
  - echo $env:CI_PROJECT_DIR
  - & "$msbuild" (Join-Path $env:CI_PROJECT_DIR "build\myproject.sln")

方法2：用大括号明确变量边界 #

script:
  - mkdir build
  - cmake.exe -Bbuild -DBUILD_DEPS=ON
  - echo $env:PATH
  - echo $env:CI_PROJECT_DIR
  - & "$msbuild" "${env:CI_PROJECT_DIR}\build\myproject.sln"

方法3：使用子表达式明确变量 #

script:
  - mkdir build
  - cmake.exe -Bbuild -DBUILD_DEPS=ON
  - echo $env:PATH
  - echo $env:CI_PROJECT_DIR
  - & "$msbuild" "$($env:CI_PROJECT_DIR)\build\myproject.sln"

关键说明 #

• &是PowerShell的调用操作符，用于执行路径包含空格的可执行文件，必须配合引号使用。
• Join-Path是PowerShell内置的路径拼接命令，自动处理Windows的路径分隔符，避免手动拼接出错。
• 用${变量名}或$($变量名)可以明确变量的边界，防止PowerShell将变量后的特殊字符（如\）误认为变量名的一部分。

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