带with_items循环的Ansible YAML Playbook运行报错排查

这类报错是YAML缩进不规范引发的结构层级错位，和Ansible循环的功能逻辑没有关系，具体触发点和排查方向如下：

• 最外层Play的同级配置必须对齐：- name: test-loop、hosts: machine1、become: True、tasks这几个属于同一个Play的同级配置块，缩进必须完全一致，不能出现任意一行多/少空格的情况。
• 你看到的报错标记指向tasks下的任务定义位置，核心触发原因是任务块的缩进混乱：
  YAML解析器遇到层级错位时，经常会把报错标记的位置往上回溯到最近的列表定义行，你看到的箭头指在- name: "Installing Packages"这行上方，不代表这行的写法有问题，通常是这行下属的配置缩进不对等，导致解析器无法识别任务块结构，连带抛出语法错误。
  你原始代码里的缩进问题非常典型：

  tasks:
       - name: "Installing Packages"
         apt:
            name: "{{item}}"
            state: present 
         with_items:
                   - tree
                   - apache2
  

  这里with_items下的两个包名前面加了远多于with_items本身的缩进，已经脱离了列表的层级要求，属于典型的层级错位；同时state: present行末尾残留的多余空格，也可能被严格的YAML解析器判定为格式异常。
• 额外注意：写YAML时绝对不能用Tab做缩进，必须统一使用2个或4个空格的缩进规则，所有同级配置项的前置空格数必须完全一致。

- name: test-loop
  hosts: machine1
  become: True
  tasks:
    - name: "Installing Packages"
      apt:
        name: "{{ item }}"
        state: present
      with_items:
        - tree
        - apache2

不需要逐行猜测格式问题，写完Playbook后直接在本地执行Ansible自带的语法校验命令，会直接定位到具体出错的行号和原因：
ansible-playbook --syntax-check 你的playbook文件名.yml

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