Jinja2中引号前反斜杠转义异常及替代方案咨询

以下代码因三元表达式中的\"执行失败，转义反斜杠会导致路径中添加过多反斜杠：

- name: Copy files to required directory
  ansible.windows.win_copy:
    src: '{{ hotfix_backout |
             ternary(hotfix_temp_dir ~ "\hotfix\backup\" ~ item,
                     hotfix_temp_dir ~ "\hotfix\" ~ item) }}'
    dest: C:\Program Files\app\
    remote_src: true
  loop:
    - One.dll
    - Two.dll

而以下代码可正常运行：

- name: Copy files to required directory
  ansible.windows.win_copy:
    src: '{{ hotfix_backout |
             ternary(hotfix_temp_dir ~ "\hotfix\backup" ~ sep ~ item,
                     hotfix_temp_dir ~ "\hotfix" ~ sep ~ item) }}'
    dest: C:\Program Files\app\
    remote_src: true
  loop:
    - One.dll
    - Two.dll
  vars:
    sep: \

疑问： #

1. 为何仅引号前的反斜杠会引发问题？
2. 除使用sep变量外还有哪些解决办法？

问题原因解析 #

这是YAML与Jinja2双重语法解析叠加导致的：

• 你写的\"里，反斜杠在YAML层面是转义符，作用是让后面的"被解析成普通引号"。但这个反斜杠完成转义任务后不会被YAML丢弃，会被保留下来传递给Jinja2，最终导致路径里多出不必要的反斜杠，破坏路径格式。
• 而路径中间的\hotfix这类反斜杠，后面没有跟着YAML需要转义的特殊字符（比如引号），所以YAML会直接把它当作普通路径分隔符，不会触发转义逻辑，自然能正常传递给Jinja2，不会出问题。

其他解决办法 #

除了用sep变量存储反斜杠，还有这些可行方案：

1. 使用正斜杠替代反斜杠 #

Windows系统本身支持正斜杠作为路径分隔符，直接替换后无需处理转义：

- name: Copy files to required directory
  ansible.windows.win_copy:
    src: '{{ hotfix_backout |
             ternary(hotfix_temp_dir ~ "/hotfix/backup/" ~ item,
                     hotfix_temp_dir ~ "/hotfix/" ~ item) }}'
    dest: C:\Program Files\app\
    remote_src: true
  loop:
    - One.dll
    - Two.dll

2. 用Jinja2的pathjoin过滤器 #

利用Ansible提供的路径拼接过滤器，自动适配系统分隔符，避免手动拼接的转义问题：

- name: Copy files to required directory
  ansible.windows.win_copy:
    src: '{{ hotfix_backout |
             ternary(pathjoin(hotfix_temp_dir, "hotfix", "backup", item),
                     pathjoin(hotfix_temp_dir, "hotfix", item)) }}'
    dest: C:\Program Files\app\
    remote_src: true
  loop:
    - One.dll
    - Two.dll

pathjoin会根据目标系统自动生成对应分隔符的路径，Windows下会输出反斜杠格式，兼容性更好。

3. 双反斜杠转义 #

在YAML中用双反斜杠表示一个普通反斜杠，YAML解析后会保留单个反斜杠传递给Jinja2：

- name: Copy files to required directory
  ansible.windows.win_copy:
    src: '{{ hotfix_backout |
             ternary(hotfix_temp_dir ~ "\\hotfix\\backup\\" ~ item,
                     hotfix_temp_dir ~ "\\hotfix\\" ~ item) }}'
    dest: C:\Program Files\app\
    remote_src: true
  loop:
    - One.dll
    - Two.dll

4. 用Jinja2原始字符串标记 #

把需要保留反斜杠的部分用{% raw %}包裹，让Jinja2不解析其中的转义符：

- name: Copy files to required directory
  ansible.windows.win_copy:
    src: '{{ hotfix_backout |
             ternary(hotfix_temp_dir ~ {% raw %}"\hotfix\backup\"{% endraw %} ~ item,
                     hotfix_temp_dir ~ {% raw %}"\hotfix\"{% endraw %} ~ item) }}'
    dest: C:\Program Files\app\
    remote_src: true
  loop:
    - One.dll
    - Two.dll

内容的提问来源于Stack Exchange，提问作者Kimmel