Ansible lineinfile模块疑问：为何替换最后一个匹配项而非首个？

你的问题出在**backrefs: yes参数的使用搭配了旧版本Ansible**，以及对模块行为的误解：

1. 默认行为 vs backrefs模式的差异
   lineinfile模块默认（不设置backrefs: yes）确实会替换文件中的第一个匹配项，但一旦开启backrefs: yes，模块的行为会根据Ansible版本发生变化：

   • 在Ansible 2.9及以后版本：backrefs: yes会替换所有匹配正则的行；
   • 在Ansible 2.8及更早版本：backrefs: yes会替换最后一个匹配的行——这正好是你遇到的现象。

2. 针对需求的修复方案
   如果你需要替换第一个匹配项，分两种情况处理：

   情况1：不需要反向引用 #

   直接去掉backrefs: yes参数，模块会自动替换第一个匹配行：

   - name: replace first matching line
     lineinfile:
       regexp: '^(the \w+ match)$'
       line: 'THIS IS the first match'
       path: "{{ file }}"
   

   情况2：需要使用反向引用 #

   旧版本Ansible的lineinfile无法在backrefs模式下只替换第一个匹配项，改用replace模块实现，它支持指定替换次数：

   - name: replace first matching line with backrefs
     replace:
       path: "{{ file }}"
       regexp: '^(the \w+ match)$'
       replace: 'THIS IS \1'
       count: 1
   

   count: 1参数会限制只替换第一个匹配项，同时支持反向引用，不受Ansible版本差异影响。

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