yaml语法错误是workbuddy报错主因，需检查缩进一致性、冒号后空格、引号与特殊字符转义、用在线工具校验，并启用workbuddy内置kubernetes schema验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用WorkBuddy辅助编写Kubernetes配置文件时触发报错，且提示与YAML格式相关，则很可能是YAML语法不合法导致解析失败。以下是多种可立即执行的排查与修复方法：
一、检查缩进与空格一致性
YAML对缩进极其敏感，禁止使用Tab字符，必须全部使用空格，且同级字段需保持相同缩进量。混用Tab和空格或缩进层级错位会直接导致解析失败。
1、打开配置文件，在编辑器中启用“显示不可见字符”功能（如VS Code中按Ctrl+Shift+P → 输入“Toggle Render Whitespace”并回车）。
2、逐行确认所有缩进均由空格构成，无Tab符号；重点检查metadata、spec、containers等嵌套块的起始列是否对齐。
3、将光标置于疑似缩进异常的行首，按Delete键删除前导空白，再手动按空格键重新缩进，确保每级缩进为2个或4个空格（全文件统一）。
二、验证冒号后必须有空格
YAML规定键名与值之间的冒号后必须紧跟至少一个空格，否则会被识别为字符串字面量而非键值对，引发解析错误。
1、搜索所有形如image:nginx或replicas:3的行。
2、将每处冒号后的内容替换为冒号+单个空格+原内容，例如改为image: nginx、replicas: 3。
3、特别注意引号包裹的值，如env: [{"name":"APP_ENV","value":"prod"}]属于非法内联JSON写法，应改用标准YAML列表结构。
三、校验引号与特殊字符转义
包含冒号、井号、星号、斜杠等特殊字符的字符串值若未加引号，易被误解析；含换行或制表符的值还需使用字面量块符号（|）或折叠块符号（>）。
1、对所有含:、#、&、*、?、{、}、[、]、,、`的字符串值，强制添加双引号包裹，例如name: "my-app:v2.1#beta"。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
2、对于多行环境变量或ConfigMap数据，将data:下内容改为以|开头的块格式，并确保后续行缩进严格一致。
3、检查是否存在未闭合的单引号或双引号，例如message: 'error occurred缺少末尾单引号，需补全为message: 'error occurred'。
四、使用在线YAML校验工具快速定位
脱离IDE依赖，通过独立第三方校验器获取精确错误位置与类型，避免编辑器插件误报或漏报。
1、访问 https://yamlchecker.com/ 或 https://www.yamllint.com/。
2、将完整K8s YAML内容（包括---分隔符）粘贴至输入框，点击“Validate”按钮。
3、记录返回的行号与错误描述，如Line 12: did not find expected key，回到编辑器定位该行及上一行的缩进或冒号格式。
五、启用WorkBuddy内置YAML Schema验证
WorkBuddy支持加载Kubernetes官方OpenAPI v3 Schema，可实时比对字段名、类型、必填项，捕获语义级错误（如spec.template.spec.containers.name缺失）。
1、在WorkBuddy设置中查找YAML Schemas或Kubernetes Validation选项，启用开关。
2、确保已配置正确的K8s版本Schema URL，例如https://raw.githubusercontent.com/kubernetes/kubernetes/master/api/openapi-spec/v3/apis__v1_openapi.json。
3、保存文件后观察编辑器右侧或底部状态栏是否出现✅ Valid Kubernetes YAML或具体字段报错提示，按提示修正字段路径与值类型。
