Netplan YAML报错多因格式错误而非逻辑错误，关键识别点包括：invalid yaml: found character '\t'（Tab字符）、expected （冒号后缺空格或缩进不一致）、invalid value for 'dhcp4'（布尔值大小写/数值错误）、unknown key（键名拼写错误）；排查需用cat -A查Tab和$结尾空格、grep查缩进一致性，并注意addresses、ethernets下缩进及冒号、短横线后必须有空格。
Netplan 的 YAML 配置一旦报错，多数问题其实就藏在“空格”和“换行”里——不是逻辑错，是格式错。它不报具体行号，但错误类型非常固定，掌握几个关键识别点，30秒内就能定位。
看报错关键词直接锁定错误类型
执行 sudo netplan apply 或 sudo netplan validate 时，常见报错及其含义如下：
- invalid yaml: found character '\t' → 文件混入了 Tab 字符，必须全部替换为空格
-
expected
或 could not find expected ':' → 冒号后缺空格，或某行缩进突然变深/变浅 -
invalid value for 'dhcp4' → 布尔值写成了
dhcp4: true（✅）还是dhcp4: True/dhcp4: 1（❌） - unknown key 'address'（少了个 s）→ 键名拼写错误，YAML 不容错别字
用两步法肉眼排查缩进与空格
不要靠眼睛数空格，用终端命令快速暴露问题：
Ubuntu 26.04
下载
Ubuntu 26.04 LTS（代号“Resolute Raccoon”）是Canonical于2026年4月23日发布的下一代长期支持版操作系统，提供长达10年的技术支持。它搭载Linux 7.0内核与GNOME 50桌面环境，全面转向Wayland协议，并引入Rust重写的核心工具以增强安全性。官方提供适用于AMD64和ARM64架构的桌面及服务器ISO镜像，是追求前沿技术与极致稳定的开发者
- 运行
cat -A /etc/netplan/*.yaml：Tab 会显示为^I，结尾多余空格显示为$ - 运行
grep -n "^[[:space:]]*[^[:space:]]" /etc/netplan/*.yaml | head -5查看每行首非空字符的位置，确认是否统一为 2 空格缩进 - 特别注意
ethernets:下的网卡名、addresses:下的列表项，这两处最常因缩进多1空格或少1空格而失效
检查冒号、破折号、引号三类标点细节
YAML 对标点极其敏感，以下写法看似一样，实际全错：
-
addresses:[192.168.1.100/24]❌（冒号后没空格）→ 正确是addresses: [192.168.1.100/24] -
-192.168.1.100/24❌（短横后没空格）→ 正确是- 192.168.1.100/24 -
gateway4: "192.168.1.1"✅ 可用但非必须；gateway4: '192.168.1.1'✅；但gateway4: 192.168.1.1也✅（IP 字符串无需引号）
用 netplan try + 实时验证避免断网
别直接 apply，先用安全方式测试：
- 执行
sudo netplan try→ 会加载配置并等待你确认，120 秒内无操作自动回滚 - 期间立刻运行
ip a和ip r看地址和路由是否出现，比等报错更直观 - 若失败，它会提示 “Configuration failed. Reverting.” 并保留原始配置，不会锁死连接
