GitLab CI/CD变量写入gitlab-ci.yml时如何保留\n转义字符不换行

问题场景 #

在GitLab CI/CD流程中，将CI/CD变量值通过sed命令替换写入目标文件时，变量值内的\n转义字符没有被原样保留，而是被sed解析为实际换行符，不符合预期。

复现代码 #

PRIVATE_KEY='-----BEGIN PRIVATE KEY-----\nMIIEvQIBA\n-----END PRIVATE KEY-----\n'
sed -i -e s,PRIVATE_KEY,"$PRIVATE_KEY",g key.json

实际错误输出 #

执行后文件内的内容为多行格式，所有\n都被替换成了实际换行：

-----BEGIN PRIVATE KEY-----
MIIEvQIBA
-----END PRIVATE KEY-----

预期输出是保留字面量\n字符，不触发换行。

问题原因 #

sed的替换逻辑默认会解析替换字符串中的转义序列，\n会被sed识别为换行标记，不会作为普通字符串写入文件。

可行解决方案 #

• 方案1：提前转义变量中的反斜杠
  在传入sed之前，先把变量内的所有单个反斜杠替换为双反斜杠，sed解析\\n时就会输出字面量\n：

  # 转义变量中的反斜杠
  ESCAPED_KEY=$(printf '%s' "$PRIVATE_KEY" | sed 's/\\/\\\\/g')
  # 用转义后的变量执行替换
  sed -i "s,PRIVATE_KEY,${ESCAPED_KEY},g" key.json
  

• 方案2：换用awk执行替换
  awk默认不会主动解析替换内容中的转义字符，可以直接原样传入变量值完成替换，不需要额外转义：

  awk -v replace_str="$PRIVATE_KEY" '{gsub(/PRIVATE_KEY/, replace_str); print}' key.json > tmp_file && mv tmp_file key.json
  

• 方案3：GitLab CI场景适配
  如果是直接引用GitLab CI/CD页面配置的变量，注意不要在变量值外层额外加单/双引号，避免shell层面提前解析转义字符，配合上述转义逻辑使用即可。

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