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_servers
remote_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 生效，属于真正意义上的“最局部”：

Obsidian (Linux)

操作 Obsidian 库（纯 Markdown 笔记），并通过 notesmd-cli 实现自动化。

下载

• 变量不能被同一 play 中的其他 task 引用
• 常用于临时计算、条件分支中的一次性值，比如动态生成文件名、拼接路径等
• 注意缩进：必须与 name 对齐，且在 module 参数之前

示例：

- name: Deploy config for current host
vars:
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 传参，适合覆盖默认配置