Windows Batch传递含换行符环境变量作为参数的问题

问题场景 #

从GitLab Runner传入Windows Batch的环境变量如下：

PIPELINE_ID = 12345
COMMIT_SHA = 123456abcdef
COMMIT_MESSAGE = "This is a message that
contains
newlines"

这些变量在Bash中可正常使用，但执行Batch命令：

call process_release --notes "%PIPELINE_ID% %COMMIT_SHA% %COMMIT_MESSAGE%" > release.log

时，PIPELINE_ID和COMMIT_SHA传递正常，但COMMIT_MESSAGE部分触发错误：

'This' is not recognized as an internal or external command,
operable program or batch file.
'contains' is not recognized as an internal or external command,
operable program or batch file.
'newlines' is not recognized as an internal or external command,
operable program or batch file.

同时release.log文件未生成。

核心原因 #

Windows Batch对含换行的变量处理逻辑与Bash不同：直接用%COMMIT_MESSAGE%展开时，换行符会被解析为命令分隔符，导致换行后的内容被当成独立命令执行，进而触发错误并中断整个流程，重定向也因此失效。

解决方案 #

1. 启用延迟扩展处理变量 #

修改Batch脚本，启用延迟扩展后用!COMMIT_MESSAGE!替代%COMMIT_MESSAGE%，确保变量作为整体展开：

@echo off
setlocal enabledelayedexpansion
call process_release --notes "%PIPELINE_ID% %COMMIT_SHA% !COMMIT_MESSAGE!" > release.log
endlocal

延迟扩展会将含换行的变量完整传递给目标程序，不会拆分内容为多个命令。

2. 预处理变量替换换行符 #

如果不需要保留换行符，可先将COMMIT_MESSAGE中的换行替换为空格或其他符号：

@echo off
setlocal enabledelayedexpansion
set "clean_message=!COMMIT_MESSAGE:\n= !"
call process_release --notes "%PIPELINE_ID% %COMMIT_SHA% !clean_message!" > release.log
endlocal

若GitLab传入的是\r\n格式换行，可调整替换规则为!COMMIT_MESSAGE:\r\n= !。

3. 验证重定向有效性 #

若release.log仍未生成，可先移除重定向，将命令输出到控制台测试，确认变量传递正常后再添加重定向，避免因前置错误导致重定向流程中断。

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