优先级的一般规律
Ansible 的变量优先级共二十余级，但规律可以概括为三条：第一，越靠近执行时刻的赋值越优先，命令行传入的额外变量通常压过一切；第二，越具体的范围越优先，主机变量高于组变量，子组高于父组；第三，任务与剧本内部的定义高于清单纯变量。实际使用中更稳妥的做法是避免同名变量在多处出现，把差异集中在变量目录里，让优先级机制只用于兜底。
基本信息
| 最低 | 角色默认值，表达组件通用默认 |
|---|---|
| 中间 | 清单纯变量与按层级合并的组变量 |
| 较高 | 主机变量，表达个别主机特例 |
| 更高 | 剧本与任务内部定义、注册变量 |
| 最高 | 命令行额外变量，常用于临时覆盖 |
使用与排查要点
- 单一来源：同名变量只在一处定义，避免依赖优先级推断。
- 层级对应：环境差异放环境组变量，角色差异放角色组变量。
- 临时覆盖用命令行：调试或应急时用额外变量覆盖，不进资产。
- 同级组顺序：同一层级多个组都存在同名变量时，需要显式约定合并顺序。
- 查看生效值：执行前打印关键变量的实际取值，避免上线后才发现覆盖关系错误。
- 变量命名加前缀：组件前缀可显著降低跨角色同名冲突概率。
变量目录的典型结构
变量目录的典型结构
inventory/
prod-hosts.ini
group_vars/
all.yml # 全部主机共有的基础值
env_prod.yml # 生产环境差异
env_prod/
web.yml # 生产环境内 Web 组的差异
host_vars/
web01.example.com.yml # 仅该主机的特例
# 同名变量只在一处出现，取值来源可直接由目录结构读出定义位置与优先级印象
| 定义位置 | 相对优先级 | 典型用途 |
|---|---|---|
| 角色默认值 | 最低 | 组件通用默认参数 |
| 清单纯变量 | 低 | 主机与组的固有属性 |
| 环境与角色组变量 | 中 | 按环境与角色的差异 |
| 主机变量 | 较高 | 个别主机的特例取值 |
| 任务与剧本内定义 | 高 | 流程内部临时计算 |
| 命令行额外变量 | 最高 | 调试与应急覆盖 |
排查「为什么这个值生效」时，可以直接在调试任务里打印变量来源，比通读全部变量文件更快，也更适合交给不熟悉资产结构的人执行。
同级多个组包含同一主机且定义同名变量时，合并顺序依赖组的排序规则，必要时通过组优先级参数显式控制，否则取值可能随清单维护方式变化而改变。