Ansible中'undefined'与'not defined'变量是否存在差异？

问题描述 #

在Ansible中，标注为'undefined'的变量与标注为'not defined'的变量之间是否存在差异？这两个术语常被交替使用，但想确认是否有容易被忽略的细微差别。我原本认为两者都指代未定义或未赋值的变量，这种认知是否正确？或是存在需要区分使用的场景？

为验证变量声明方式的差异，我运行了如下Playbook，但结果未达预期：

---
- name: Example play-book
  hosts: localhost
  gather_facts: no
  vars:
    # This variable is defined with a value assigned to it
    defined_var: "Hello, world!"
    # This variable is defined but has no value assigned to it
    undefined_var:
    # This variable is not defined at all
    # not_defined_var:

  tasks:
    - name: Task 1
      debug:
        var: defined_var

    - name: Task 2
      debug:
        msg: "VARIABLE IS UNDEFINED"
      when: undefined_var is undefined

    - name: Task 3
      debug:
        var: not_defined_var
      when: not_defined_var is undefined

输出结果：

PLAY [Example playbook] *******************************************

TASK [Task 1] *****************************************************
ok: [localhost] => {
    "defined_var": "Hello, world!"
}

TASK [Task 2] *****************************************************
skipping: [localhost]

TASK [Task 3] *****************************************************
ok: [localhost] => {
    "not_defined_var": "VARIABLE IS NOT DEFINED!"
}  

差异解析 #

首先明确：'undefined'和'not defined'在Ansible的测试语境中是完全等价的——Ansible的测试过滤器里，is undefined和is not defined是同一逻辑的两种表述方式，没有功能上的区别。

你的Playbook结果出现差异，核心原因是对「未赋值变量」和「未定义变量」的理解有误：

• 你声明的undefined_var:属于已定义但值为空的变量，它并不是真正的"未定义"。在Ansible中，这种变量的实际值是None（Python的空值），所以undefined_var is undefined的判断结果为False，导致Task 2被跳过。
• 而not_defined_var是完全未声明的变量，此时not_defined_var is undefined的判断结果为True，所以Task 3得以执行，Ansible会输出默认提示"VARIABLE IS NOT DEFINED!"。

正确的区分场景 #

如果你需要区分「已定义但为空」和「完全未定义」的变量，应该结合is defined和is none测试：

• 判断变量完全未定义：var is undefined（或var is not defined）
• 判断变量已定义但值为空：var is defined and var is none

内容的提问来源于stack exchange，提问作者dror1212