批处理中变量名后添加"_name"后缀的含义是什么？

实验结果整理 #

实验1：变量名a的表现 #

@echo off

set a="5"

echo %a%
echo %a_name%
echo %a_something%
echo a: %a%
echo a: %a_name%
echo a: %a_something%

输出：

"5"
5
ECHO is off.
a: "5"
a: 5
a:

实验2：变量名b的表现（普通变量对照） #

@echo off

set b="5"

echo %b%
echo %b_name%
echo %b_something%
echo b: %b%
echo b: %b_name%
echo b: %b_something%

输出：

"5"
ECHO is off.
ECHO is off.
b: "5"
b:
b:

实验3：变量名branch的表现 #

@echo off

set branch="5"

echo %branch%
echo %branch_name%
echo %branch_something%
echo branch: %branch%
echo branch: %branch_name%
echo branch: %branch_something%

输出：

"5"
(echo get-branch-name)
ECHO is off.
branch: "5"
branch: (echo get-branch-name)
branch:

补充测试 #

我额外做了以下测试，所有结果均与普通变量b的表现一致：

• 将变量命名为git，测试其与含git开头的文件git-push、git-commit的关联
• 将变量命名为merge，测试其与唯一文件名merge-sprint的关联
• 创建文件my-merge-sprint，测试变量名在文件名开头和中间的情况
• 保留上述文件并删除merge-sprint，测试变量名在文件名中间的情况
• 将文件重命名为merge-sprint-name，测试文件名以name结尾的情况
• 将文件重命名为my-merge-sprint-name，测试变量名在文件名中间且文件名以name结尾的情况

原理解析 #

1. 变量名a的特殊行为 #

这是批处理遗留解析规则导致的：当你使用%a_name%时，由于未定义a_name变量，解析器会错误将其识别为%~n%a%——即提取变量a值的「文件名部分」。因为你设置a="5"，%~n"5"会自动去掉引号并提取文件名（此处字符串本身即为文件名），所以输出5。

这种行为是a独有的特殊处理（旧版DOS/CMD解析器的bug或设计），其他单个字符变量（如b）无此问题。

2. 变量名branch的特殊行为 #

你的情况是因为当前环境中存在预定义的branch_name环境变量，其值为(echo get-branch-name)。这个变量可能由你之前运行的get-branch-name.bat脚本、Git工具或其他程序自动设置。

后续测试git、merge等变量时无类似情况，是因为对应的git_name、merge_name等环境变量不存在，所以表现与普通变量一致。

验证方法 #

1. 针对a的情况：在脚本开头添加set a_name="test"，此时%a_name%会输出"test"，证明当变量存在时，解析器会优先使用已定义值。
2. 针对branch的情况：在脚本开头添加set branch_name=（清空变量），此时%branch_name%会输出ECHO is off.，与普通变量表现一致。

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