使用变量替代硬编码值时Git命令输出至文本文件为空的原因排查

问题分析 #

你遇到的核心问题是：用硬编码标签时git log的输出能正常写入文件，但用变量存储标签后，命令行能显示正确内容，生成的文件却为空。这种情况大概率是变量中包含了多余的空白字符（换行、空格），或是批处理变量扩展机制导致的解析异常。

解决方案 #

1. 正确捕获Git标签（避免多余字符） #

首先要确保获取标签时，变量不会带上换行、空格这类多余字符。用for /f命令来捕获最近两个标签，它会自动忽略空白行和多余空格：

@echo off
setlocal enabledelayedexpansion

:: 获取最近创建的两个标签，按创建时间倒序
for /f "skip=0 tokens=1" %%t in ('git tag --sort=-creatordate') do (
    if not defined NewTag (
        set "NewTag=%%t"
    ) else (
        set "OldTag=%%t"
        goto :tag_captured
    )
)
:tag_captured

:: 验证变量内容（可选，用于排查）
echo OldTag: '!OldTag!'
echo NewTag: '!NewTag!'

2. 用延迟扩展执行Git Log #

启用延迟扩展后，用!变量名!代替%变量名%，能避免变量扩展时的字符解析问题，确保标签范围正确传递：

:: 执行Git Log并写入文件
git log --format="%%s" !OldTag!..!NewTag! > "C:\Documentation\Commits.txt"

完整示例脚本 #

@echo off
setlocal enabledelayedexpansion

:: 捕获最近两个标签
for /f "skip=0 tokens=1" %%t in ('git tag --sort=-creatordate') do (
    if not defined NewTag (
        set "NewTag=%%t"
    ) else (
        set "OldTag=%%t"
        goto :run_log
    )
)

:run_log
:: 输出到文件
git log --format="%%s" !OldTag!..!NewTag! > "C:\Documentation\Commits.txt"

:: 可选：显示文件内容验证
type "C:\Documentation\Commits.txt"
endlocal

为什么原来的写法会出问题？ #

• 如果直接用set命令获取标签（比如通过管道输出赋值），很容易把换行符或末尾空格存入变量，导致%NewTag%实际包含标签名\r这类不可见字符。Git在命令行中会忽略这类字符正常输出，但重定向时会因为解析异常导致文件为空。
• 批处理的普通变量扩展（%变量%）会在命令执行前完成，如果变量包含特殊字符（比如空格、括号），会破坏命令结构，而延迟扩展（!变量!）会在命令执行时解析，能避免这类问题。

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