GitLab Pipeline中无法运行WiX Toolset v3的light命令求助

问题原因 #

Chocolatey安装WiX Toolset后，light.exe所在的目录不会自动加入当前PowerShell会话的PATH环境变量。本地Windows机器安装后，系统会自动刷新环境变量或你重启了终端，环境变更会生效；但GitLab的Windows runner是临时一次性会话，安装后的环境变量变更不会自动加载，导致系统识别不到light命令。

解决措施 #

• 手动添加路径到当前会话：WiX Toolset V3.14.1默认安装路径为C:\Program Files (x86)\WiX Toolset v3.14\bin，在安装命令后添加：

  $env:PATH += ";C:\Program Files (x86)\WiX Toolset v3.14\bin"
  

• 刷新环境变量：使用Chocolatey的refreshenv命令强制刷新当前会话的环境变量：

  refreshenv
  

• 直接使用完整路径执行：跳过环境变量配置，直接调用light.exe的完整路径：

  & "C:\Program Files (x86)\WiX Toolset v3.14\bin\light.exe" [你的编译参数]
  

验证步骤 #

添加路径或刷新环境后，可先执行以下命令确认light命令是否可用：

Get-Command light

或

where.exe light

内容的提问来源于stack exchange，提问作者Gabriel Freitas Yamamoto