使用envsubst时如何阻止Bash环境变量自动转为绝对路径？

在Windows的Bash环境（例如Git Bash）中使用envsubst替换YAML文件变量时，会遇到斜杠开头的字符串被自动转换为Windows绝对路径的问题，比如你遇到的/some/handle/for/volume被替换成C:/Program Files/Git/some/handle/for/volume。

你的测试文件与脚本 #

test.yaml：

apiVersion: v1
kind: PersistentVolume
metadata:
  name: pv-azuredisk
spec:
  capacity:
    storage: ${SIZE}Gi
  accessModes:
    - ReadWriteOnce
  persistentVolumeReclaimPolicy: Retain
  storageClassName: managed-csi
  csi:
    driver: disk.csi.azure.com
    readOnly: false
    volumeHandle: ${VALUE}
    volumeAttributes:
      fsType: ext4

执行脚本：

value="/some/handle/for/volume"
size=20

export VALUE=$value SIZE=$size

echo "$(envsubst '$VALUE:$SIZE' < ./test.yaml)"

问题原因 #

这是Windows下Git Bash的特性：它会自动将POSIX风格的路径转换为Windows路径，而envsubst在这个环境中继承了该行为，导致以/开头的字符串被识别为路径进行转换。Linux环境下不存在这个问题，因为没有跨路径风格的转换逻辑。

解决方案 #

最直接的方法是临时禁用Git Bash的路径转换功能，通过设置MSYS_NO_PATHCONV环境变量实现：

方法1：临时在命令行中设置变量

value="/some/handle/for/volume"
size=20

export VALUE="$value" SIZE="$size"

# 执行envsubst时禁用路径转换
MSYS_NO_PATHCONV=1 echo "$(envsubst '$VALUE:$SIZE' < ./test.yaml)"

方法2：将变量导出到当前环境

如果需要多次执行envsubst，可以先导出变量：

export MSYS_NO_PATHCONV=1
value="/some/handle/for/volume"
size=20

export VALUE="$value" SIZE="$size"
echo "$(envsubst '$VALUE:$SIZE' < ./test.yaml)"

这样envsubst就会将$VALUE的值视为纯字符串，不会进行路径转换。

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