GitLab Secret Variables特殊字符转义：如何转义!等字符？

算力阿峰

2026-5-19

这个问题我碰到过好多次，核心原因是!这类特殊字符会被你的shell（不管是Windows CMD还是Linux Bash/Zsh）当成特殊语法解析，而不是直接作为变量内容输出。下面分两种最常见的场景给你解决方案：

1. 如果你用的是Windows CMD环境（GitLab Runner跑在Windows上）

CMD里的!是延迟变量扩展的标记，默认情况下可能是开启的，这会导致变量里的!被shell吃掉或者解析成其他内容。

有两种靠谱的解决方式：

方式一：在CI脚本里临时关闭延迟扩展
在输出变量的步骤前先关闭延迟扩展，输出完再恢复（可选）：
```
@echo off
setlocal DISABLEDELAYEDEXPANSION
echo %MySecretVar%
endlocal
```
方式二：在设置GitLab Secret Var时转义!
把变量值里的!用^转义，比如你的原始值是foo!bar，就写成foo^!bar存到Secret Var里。CMD解析时会把^!识别为普通的!。

2. 如果你用的是Linux/macOS的Bash/Zsh环境（GitLab Runner跑在类Unix系统上）

Bash里的!是历史命令扩展的特殊字符（比如!$代表上一条命令的最后参数），直接输出变量时会被shell解析。

推荐这两种方法：

方式一：用双引号包裹变量输出
双引号会阻止shell解析!这类特殊字符，同时正常展开变量：
```
echo "$MySecretVar"
```
方式二：临时关闭历史扩展
如果变量里的!位置比较特殊（比如开头），可以在脚本里先关闭历史扩展再输出：
```
set +o histexpand
echo "$MySecretVar"
set -o histexpand
```
当然也可以在设置Secret Var时给!加反斜杠转义，比如foo\!bar，Bash会把\!解析为普通的!。