在子shell中通过HereDoc定义环境变量的异常问题排查

问题根源 #

你遇到的是HereDoc变量提前展开的问题：当使用不带引号的EOF时，当前shell会先解析HereDoc内容里的变量（比如$VAR），但此时你的当前shell环境中并没有定义VAR，所以$VAR被展开成空字符串，最终写入文件的就变成了echo ，导致脚本运行时没有输出。

解决方法 #

将HereDoc的结束标记EOF用单引号括起来（双引号也可，但单引号能彻底阻止变量解析），这样bash会完全保留HereDoc里的原始内容，不会提前展开变量：

cat <<'EOF' >> test.sh
#!/bin/bash
# test.sh
VAR="Test"
echo $VAR
EOF

验证步骤 #

1. 执行上述命令后，用cat test.sh查看文件内容，会发现echo $VAR被完整保留：

#!/bin/bash
# test.sh
VAR="Test"
echo $VAR

2. 赋予执行权限并运行脚本：

chmod +x test.sh
./test.sh

此时会正常输出Test。

补充说明 #

如果需要在HereDoc中保留部分变量展开、仅阻止特定变量解析，也可以对目标变量加反斜杠转义（比如echo \$VAR），但给结束标记加单引号是最省心的方式，适合需要完整保留脚本代码的场景。

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