ansible-playbook命令找不到是因为安装不全：centos/rhel 7中ansible与ansible-playbook分属不同包，需先启用epel并安装完整版；ubuntu则须用官方ppa源。
ansible-playbook 命令找不到？先确认安装完整性
不是没装，而是装得不全。CentOS 7/RHEL 7 的 EPEL 源里，ansible 和 ansible-playbook 是两个包；只运行 yum install ansible 会漏掉后者。
Ubuntu 20.04+ 默认包含，但若用的是非官方源（比如某些国内镜像），可能裁剪掉了 CLI 工具。
- CentOS/RHEL：先确保 EPEL 已启用：
yum install -y epel-release，再装完整版：yum install -y ansible - Ubuntu：优先加官方 PPA：
sudo add-apt-repository --yes ppa:ansible/ansible && sudo apt update && sudo apt install -y ansible - 验证是否真装上：
ls /usr/bin/ansible*，输出里必须含ansible-playbook
执行时报 UNREACHABLE! 或 Failed to connect？检查 SSH 连通性
Ansible 不是凭空连上的，它完全复用你本地的 SSH 配置。报连接失败，和你手动 ssh user@host 是否成功一模一样。
- 先手动试：
ssh -o ConnectTimeout=5 -o BatchMode=yes your_user@192.168.1.10—— 必须秒进、不输密码、不提示 known_hosts 冲突 - 确认 inventory 路径：默认读
/etc/ansible/hosts，自定义路径必须显式带-i参数，例如：ansible-playbook -i ~/my-inventory site.yml - become 权限卡住？如果任务写了
become: true，但远程用户没有免密 sudo 权限，就会 hang 住；调试时可用--ask-become-pass，长期应配%wheel ALL=(ALL) NOPASSWD: ALL（用visudo）
Playbook 写完不执行？YAML 缩进和模块名是高频雷区
Ansible 对空格极其敏感，且模块行为在不同版本中已有调整。常见错误不是逻辑错，而是格式或拼写错。
- 缩进必须用空格，不能混用 Tab；
tasks下每个- name:任务要顶格对齐，其下模块参数缩进 2 空格（如user:后的name:和state:） - 老教程里的
apt模块仍可用，但推荐显式写ansible.builtin.apt；shell和command行为不同：shell支持管道和变量展开，command更安全但不支持 shell 特性 - 变量引用必须用双花括号：
{{ nginx_port }}，漏掉任一括号或空格都会导致解析失败
跑之前必须做的两件事：语法检查 + 空跑验证
直接 ansible-playbook xxx.yml 上线风险极高。真实环境里，90% 的低级错误都能被这两步拦截。
- 语法检查：
ansible-playbook --syntax-check site.yml—— 输出playbook: site.yml才算过关，警告（WARNING）可忽略，ERROR 不行 - 空跑看效果：
ansible-playbook --check --diff site.yml——--check模拟执行，--diff显示文件变更差异，能提前发现配置覆盖、权限错误等 - 别跳过
--list-hosts和--list-tasks：确认目标主机和任务顺序是否符合预期，尤其当用了when或tags时
实际跑起来后，changed=1 比 ok=2 更值得关注——它意味着系统状态确实被修改了。而幂等性是否生效，得靠第二次执行时看 changed=0 才算真正立住。
