Kubernetes YAML清单缩进有效性不一致及版本相关问题咨询

一、为什么同一YAML片段被不同工具判定/格式化不一致？ #

YAML版本差异是次要因素，核心是工具的配置、风格校验规则差异：

• YAML 1.1和1.2确实存在语法差异（比如特殊字符处理逻辑），但你遇到的缩进问题不属于版本差异范畴——YAML规范本身只要求同一列表内的项缩进一致，并没有强制规定列表项与父键的缩进关系。
• 不同工具自带的风格校验规则是差异根源：
  • 本地yamllint（Python包）默认配置允许列表项相对于父键缩进2个空格；
  • yamllint.com采用了更严格的预设规则，要求列表项与父键同缩进；
  • 编辑器的自动缩进由各自插件/内置语法规则决定：Vim90的yaml.vim语法文件默认设置列表项缩进，而VS Code的Kubernetes插件遵循K8s官方推荐的缩进风格。

二、如何确认Kubernetes使用的YAML版本？ #

• Kubernetes的API服务器基于Go语言的gopkg.in/yaml.v2或yaml.v3库解析YAML，这两个库兼容YAML 1.1和1.2，但K8s官方推荐遵循YAML 1.2规范。
• 实际验证方式：
  • 执行kubectl apply --dry-run=client -f your-manifest.yaml测试，只要命令无报错，说明K8s可正常解析该YAML；
  • 核心判断标准不是YAML版本，而是YAML内容是否符合对应K8s API版本的Schema（如字段类型、必填项、嵌套结构等），可通过kubectl explain命令查看API字段规范（例如kubectl explain pod.spec.initContainers）。

三、如何查询各工具的YAML解析版本/规则？ #

• yamllint（Python包）：
  • 查看版本：运行yamllint --version；
  • 查看默认校验规则：运行yamllint --show-config，重点关注indentation规则的配置；
  • 它依赖PyYAML库，PyYAML默认支持YAML 1.1，可通过修改配置启用YAML 1.2支持。
• yamllint.com：
  • 该网站采用预设的严格风格校验规则，解析逻辑基于固定的前端YAML解析库，规则无法自定义，差异主要来自与本地yamllint的配置不同。
• Visual Code：
  • 查看YAML相关插件（如Kubernetes、YAML）的设置：在设置面板搜索yaml indent，可查看当前缩进规则；
  • 其解析依赖yaml-language-server，默认支持YAML 1.2，同时会结合K8s Schema进行校验。
• Vim90：
  • 查看当前YAML缩进配置：在Vim中运行:set yaml-indent?；
  • 缩进规则由内置的yaml.vim语法文件控制，可通过在.vimrc中设置let g:yaml_indentation = 2（或其他值）调整缩进行为。

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