如何在Ansible中为字符串特殊字符添加反斜杠转义符

需求说明 #

编写Ansible playbook时，接收的用户输入字符串可能包含双引号、圆括号等特殊字符，需要在每个目标特殊字符前添加反斜杠\完成转义，转换示例如下：

原始字符串：
"(msg.commandCode=303 or msg.commandCode=302 or msg.commandCode=301) and msg.dest-host avpExists"
目标转换结果：
\"\(msg.commandCode=303 or msg.commandCode=302 or msg.commandCode=301\) and msg.dest-host avpExists\"

最优实现：使用内置regex_replace过滤器 #

不需要额外开发自定义模块，直接用Ansible Jinja2内置的正则替换过滤器即可完成需求，核心逻辑是通过正则捕获所有需要转义的特殊字符，替换时在字符前追加反斜杠。

示例代码 #

- name: 接收用户输入
  ansible.builtin.pause:
    prompt: "请输入待处理字符串"
  register: user_input_raw

- name: 对特殊字符加反斜杠转义
  ansible.builtin.set_fact:
    escaped_str: "{{ user_input_raw.user_input | regex_replace('([\"()])', '\\\1') }}"

- name: 输出转义结果验证
  ansible.builtin.debug:
    var: escaped_str

规则说明 #

• 正则第一个参数([\"()])是捕获组，括号内列全所有需要转义的特殊字符，当前示例包含双引号"、左圆括号(、右圆括号)，如果后续需要新增转义字符（比如方括号、美元符等），直接在中括号内追加即可，例如需要转义[ ] $时，修改为([\"()\[\]$])。
• 上述写法用YAML单引号包裹正则替换参数，避免多层反斜杠转义计数错误，最终渲染效果为给每个捕获到的特殊字符前添加1个反斜杠，和示例要求的输出完全匹配。
• 如果习惯用双引号包裹Jinja2内的字符串，替换参数需要写为"\\\\\\1"才能达到相同效果，本质是YAML、Jinja2、正则引擎三层转义规则叠加的结果，容易写错，更推荐单引号写法。

场景适配提示 #

如果转义后的字符串是要传递给shell类模块（ansible.builtin.shell/ansible.builtin.command等）作为参数，不需要手动写正则枚举转义字符，直接使用Ansible内置的quote过滤器即可自动完成全场景的shell特殊字符转义，避免手动枚举出现遗漏。

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