Ansible提取文件内容替换CHANGE_ME占位符不生效问题排查

按环节逐层定位问题，无需额外加调试命令即可快速锁定根因：

• 核对模块参数语义：Ansible replace 模块中，regexp 参数定义需要在目标文件中匹配查找的内容规则，replace 参数定义匹配成功后要写入的替换值，两个参数职责完全独立、不可随意调换。
• 对照任务执行状态匹配异常点：原Playbook中replace任务执行后返回ok而非changed，代表模块在目标文件中没有匹配到任何符合regexp规则的内容，因此没有触发文件修改动作。

  原Playbook中replace任务的实际执行逻辑为：扫描file.txt全文，匹配所有和this-is-the-value（即cat_value.stdout的内容）一致的字符串，将这些字符串替换为CHANGE_ME。由于file.txt内从未出现过this-is-the-value字符串，模块自然无匹配目标、不触发修改，和用户观测到的“文件完全没改动”的现象100%吻合。

• 校验值传递链路：从debug任务的输出可以看到，cat_value.stdout 已经正确获取到了value.txt的内容this-is-the-value，说明文件读取环节无问题，故障点完全集中在替换环节的参数配对错误。

基础修正版（适配原取数逻辑） #

直接调整replace模块的参数配对，完全匹配业务目标：匹配文件中所有CHANGE_ME占位符，将占位符替换为value.txt中读取到的实际值，修正后的任务片段：

- name: modify file.txt
  replace:
    path: "{{ playbook_dir }}/file.txt"
    # regexp定义要查找的匹配内容：CHANGE_ME占位符
    regexp: "CHANGE_ME"
    # replace定义要替换成的实际值：从value.txt读到的内容
    replace: "{{ cat_value.stdout }}"

执行后replace任务会识别到3处匹配的CHANGE_ME，将其全部替换为this-is-the-value，任务状态会变为changed，符合预期修改效果。

鲁棒优化版 #

原逻辑使用shell: cat读取文件存在不必要的shell进程开销，且容易受文件尾部多余换行、特殊字符转义的影响，可以用Ansible原生的lookup方式读取文件内容，增加trim处理去除首尾多余空白，避免边界异常：

tasks:
  - name: 读取value.txt的实际替换值
    set_fact:
      replace_val: "{{ lookup('file', playbook_dir ~ '/value.txt') | trim }}"

  - name: 批量替换file.txt中的占位符
    replace:
      path: "{{ playbook_dir }}/file.txt"
      regexp: "CHANGE_ME"
      replace: "{{ replace_val }}"

注意：如果占位符字符串包含正则特殊字符（如.、*、+等），可以用\Q和\E包裹匹配内容，避免正则引擎误解析，例如regexp: "\\QCHANGE_ME\\E"。

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