优先使用 ansible_default_ipv4.address 是因它直接提供与默认路由关联的单个可靠ipv4地址，结构化、免解析、多网卡稳定，且可复用interface和gateway字段，避免硬编码和列表不确定性。
直接用 ansible_default_ipv4.address 就能拿到最常用、最可靠的 IPv4 地址，这是动态部署路由时最稳妥的取值方式。
为什么优先用 ansible_default_ipv4.address
Ansible 的 setup 模块自动收集的 facts 中，ansible_default_ipv4 是一个结构化字典，明确包含当前默认路由出口网卡的 IPv4 信息。相比 ansible_all_ipv4_addresses（返回的是字符串列表），它天然适配变量引用，无需额外处理索引或 JSON 解析。
-
ansible_default_ipv4.address直接返回单个 IP 字符串，例如"192.168.137.102" - 该地址对应系统实际用于出站通信的接口，与路由表中 default gateway 关联紧密，适合后续配置静态路由或策略路由
- 在多网卡环境中依然稳定——它由内核路由决策决定，不是按字母顺序取第一个
在 Playbook 中提取并用于路由部署
以下是一个典型用法：通过获取目标主机的默认 IP，创建以该 IP 命名的路由规则文件，并加载进系统。
PyCharm 2026.2.0.1 Linux版提供 JetBrains 官方 2026.2.0.1 版本安装包，适合需要指定 PyCharm 版本进行 Python 项目开发、运行和调试的用户。
- name: Gather network facts
setup:
gather_subset: network
name: Create route config dir file: path: "/etc/sysconfig/network-scripts/route-{{ ansible_default_ipv4.interface }}" state: touch mode: '0644'
-
name: Write static route using host's own IP as next-hop reference (e.g., for policy routing) lineinfile: path: "/etc/sysconfig/network-scripts/route-{{ ansible_default_ipv4.interface }}" line: "10.0.0.0/8 via {{ ansible_default_ipv4.gateway }} dev {{ ansible_default_ipv4.interface }}" create: yes
注意：
ansible_default_ipv4.gateway和interface同样来自同一结构，可一并复用，避免硬编码或重复查询。
过滤器辅助校验与容错
若需确保提取的值是合法 IPv4 地址（比如防止因 facts 未收集全导致空值引发错误），可用 Ansible 内置 IP 过滤器做断言：
-
{{ ansible_default_ipv4.address | ansible.netcommon.ipv4 }}—— 若非合法 IPv4，渲染时报错，便于早期发现环境异常 -
{{ ansible_default_ipv4.address | default('127.0.0.1') }}—— 提供兜底值，适用于测试或降级场景 - 组合使用：
{{ (ansible_default_ipv4.address | ansible.netcommon.ipv4) | default('127.0.0.1') }}
不推荐依赖 ansible_all_ipv4_addresses 的原因
这个变量返回的是所有 IPv4 地址组成的列表（如 ["192.168.137.102", "10.0.2.15"]），在动态路由场景中存在明显缺陷：
- 无法区分主出口接口，可能选错网关关联的地址
- 列表顺序不保证一致，
{{ ansible_all_ipv4_addresses[0] }}在不同主机上可能指向不同网卡 - 生成路由脚本或配置文件时，需额外 Jinja2 处理（如
join或first），增加出错概率
