模块参数拼写错误需在执行前定位：用--syntax-check捕获yaml结构错位，ansible-lint识别非法参数名，-vvv查看渲染后真实参数，debug模块验证变量值，ansible-doc核对官方参数列表。
模块参数拼写错误是 Ansible 执行失败中最隐蔽也最常见的一类问题——它通常不报“语法错误”，而是静默忽略参数、传入空值，或触发模块内部默认行为，最终导致任务看似成功却未达预期。排查关键在于不让错误进入执行阶段，而是在运行前定位、验证、显形。
用 --syntax-check + ansible-lint 提前拦截基础错误
虽然 --syntax-check 不检查模块参数语义，但它能捕获 YAML 层面的结构错位（比如把 src: 写成 sc: 后缩进错乱），也能发现明显拼写异常（如 moduel: copy）。更进一步，用 ansible-lint 可识别已知模块的非法参数名：
-
ansible-lint playbook.yml会提示类似[208] File module does not support parameter 'soruce'的警告 - 确保安装最新规则：
pip install --upgrade ansible-lint
用 -vvv 查看实际渲染后的参数值
Ansible 在执行前会把所有变量和 Jinja2 表达式展开。加 -vvv 后，控制台会输出每个 task 最终调用模块时的真实参数字典，一眼就能看出参数名是否被正确识别：
Zynq Linux Hardware Debug
下载
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 如果看到
"src": "{{ source_file }}"→ 说明变量已展开，参数名src被识别 - 如果看到
"sorc": "{{ source_file }}"→ 说明你写了sorc:，模块收不到，可能退化为默认行为（如 copy 模块会报错或跳过）
用 debug 模块主动验证参数上下文
在出问题的任务前插入 debug，直接打印你打算传给模块的参数组合，尤其适合动态构造参数的场景：
- name: Preview copy args<br> ansible.builtin.debug:<br> msg: "src={{ my_src }}, dest={{ my_dest }}, backup={{ my_backup | default(false) }}"- 这样能确认
my_backup是否为布尔值、是否被误写成字符串"false"（模块会当作true处理）
查模块文档并比对参数状态
不同模块对参数缺失/错误的响应差异很大：
-
copy模块：缺少src或dest会直接报missing required arguments -
lineinfile模块：写错regexp名（如写成regxp）不会报错，而是忽略该参数，变成无条件追加 —— 这就是“静默失效” - 解决办法：运行
ansible-doc -m lineinfile，对照官方参数列表逐项核对拼写与必选性
