Ansible Playbook中“局部变量”指作用域限于单个play或task的变量：play级用vars定义（仅本play生效），task级在任务下嵌套vars（仅本任务生效），或通过vars_files引入外部YAML文件实现结构化局部配置。
在 Ansible Playbook 中，“局部变量”并不是官方术语，但通常指作用范围仅限于某个 play 或某个 task 的变量。最常用、最符合“局部”含义的方式，就是在 play 级别用 vars 定义 —— 它只对当前 play 生效，不会影响其他 play，也不进入全局命名空间。
在 play 内部用 vars 定义（推荐的“局部变量”）
这是最标准、最清晰的局部变量用法。变量定义在某个 - hosts: ... 块下，紧随 hosts 和 remote_user 之后，缩进与它们对齐：
- 作用域明确：仅该 play 下的所有 tasks 可访问，不同 play 之间互不干扰
- 语法简洁：支持字符串、数字、布尔值、列表、字典等多种类型
- 无需额外文件或路径：适合参数少、环境固定的小型任务
示例：
— hosts: web_serversremote_user: root
vars:
app_port: 8080
log_dir: /var/log/myapp
enabled_features: [auth, cache]
tasks:
- name: Ensure log directory exists
file:
path: "{{ log_dir }}"
state: directory
- name: Start service with custom port
systemd:
name: myapp
state: started
environment:
PORT: "{{ app_port }}"
在单个 task 内定义变量（更窄的作用域）
Ansible 允许把 vars 放在某个 task 下方（与 name 同级），此时变量只对该 task 生效，属于真正意义上的“最局部”：
- 变量不能被同一 play 中的其他 task 引用
- 常用于临时计算、条件分支中的一次性值，比如动态生成文件名、拼接路径等
- 注意缩进：必须与
name对齐，且在module参数之前
示例：
- name: Deploy config for current hostvars:
config_file: "/etc/myapp/conf.d/{{ inventory_hostname }}.yml"
template:
src: templates/app.conf.j2
dest: "{{ config_file }}"
使用 vars_files 加载外部变量文件（结构化局部变量）
当局部变量较多或需复用时，可将它们写入独立的 YAML 文件，再通过 vars_files 在特定 play 中引入。这种方式保持了 play 级别的隔离性，同时提升了可读性和维护性：
- 变量文件内容是纯键值对，例如
web_vars.yml：
db_host: db-prod.example.com
max_connections: 200 - 在 play 中引用：
vars_files:
- web_vars.yml - 该 play 可用这些变量，其他 play 不受影响
注意事项和常见问题
定义局部变量时需避开几个典型陷阱：
-
YAML 解析问题：如果变量值以
{{开头（比如嵌套引用），整行必须用双引号包裹，否则 YAML 会报错 -
引用语法统一：所有变量都用
"{{ var_name }}"形式；变量单独作参数值时加引号，嵌入字符串中则不用额外引号（如/path/to/{{ name }}.conf） -
优先级关系：play 内
vars优先级高于group_vars和host_vars，但低于命令行-e传参，适合覆盖默认配置
