Ansible调用win_package模块传递Windows路径时转义异常问题咨询

你遇到的报错本质是YAML转义规则冲突、对win_package参数作用误解两个问题叠加导致，日志里的多重反斜杠是JSON序列化展示的正常现象，不存在误导。

三种正确的路径写法 #

• 第一种（最稳妥，无转义冲突）：使用单引号包裹路径，直接写Windows原生单反斜杠即可，YAML不会解析单引号内的转义字符

- name: Install package
  win_package:
    path: 'C:\folder\packagename'

• 第二种（通用兼容场景）：使用正斜杠作为路径分隔符，Windows原生支持正斜杠，完全避开转义问题，不需要加引号

- name: Install package
  win_package:
    path: C:/folder/packagename

• 第三种（不推荐，仅作原理说明）：如果使用双引号包裹路径，需要写双反斜杠完成YAML转义，这种写法如果路径中有\t、\n等特殊转义序列容易出现异常，不建议使用

- name: Install package
  win_package:
    path: "C:\\folder\\packagename"

高频踩坑提醒 #

win_package的path参数指向的是目标Windows主机的本地路径/可访问的UNC共享路径，不是Ansible控制节点的本地路径。如果安装包存放在控制节点上，需要先通过win_copy模块将安装包上传到目标Windows主机的对应路径后，再调用win_package执行安装，否则会直接报路径不存在的错误，这也是很多用户修改转义后仍然报错的核心原因。

日志反斜杠说明 #

你看到的报错日志里的C:\\\\folder\\\\package是JSON序列化后的展示结果：JSON中每个反斜杠需要额外加一个反斜杠转义才能正常展示，所以日志里的4个反斜杠对应实际传入模块的路径只有2个反斜杠，日志本身不存在误导。

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