必须手动绑定Tekton JSON Schema，否则Red Hat YAML插件无法识别tekton.dev/v1beta1等API组，导致Task、Pipeline等资源无补全且误报“Unexpected key”；需在settings.json中配置yaml.schemas映射至社区Schema URL并匹配文件路径模式。
为什么Tekton YAML在VSCode里没补全、老报错
因为Tekton的Task、Pipeline、TaskRun等资源类型不在通用YAML Schema里，Red Hat YAML插件默认也不识别tekton.dev/v1beta1这类API组。你看到的“Unexpected key”或“Missing required property”提示，基本都源于Schema缺失，不是语法写错了。
- 别指望只装
YAML Language Support by Red Hat就自动支持Tekton——它需要手动绑定Schema - 官方没提供公开托管的Tekton JSON Schema，得用社区维护的版本（如
https://raw.githubusercontent.com/tektoncd/plumbing/master/tekton-schema.json） - 如果你打开的是
pipeline.yaml但文件名不匹配*pipeline*.yaml这类模式，Schema根本不会加载
如何让Task和Pipeline字段有补全和校验
必须在settings.json中显式配置yaml.schemas映射，且路径模式要覆盖你的实际文件命名习惯。
- 打开设置 → 右上角“打开设置(JSON)” → 添加如下片段：
{
"yaml.schemas": {
"https://raw.githubusercontent.com/tektoncd/plumbing/master/tekton-schema.json": [
"*.task.yaml",
"*.pipeline.yaml",
"*.pipelinerun.yaml",
"*.taskrun.yaml",
"tekton-*.yaml",
"ci-*.yaml"
]
}
}- 保存后重启VSCode或重开文件；新建一个
build.task.yaml，输入apiVersion:就能看到tekton.dev/v1beta1建议 - 如果仍无提示，右键文件 → “Change Language Mode” → 选
YAML（确保不是Plain Text） - 注意：该Schema对
resources下的type: git或type: image字段也有校验，拼错会立刻标红
steps里写script总被标黄？缩进和换行规则很关键
Tekton YAML对script块的缩进极其敏感，VSCode的YAML插件一旦解析失败，就会把整段标为无效值，导致后续字段（比如env）也失去补全。
-
script:后面必须跟|或>，且下一行**必须比script:多缩进至少2格**，例如：
steps:
- name: build
image: gcr.io/kaniko-project/executor:v1.22.0
script: |
#!/busybox/sh
echo "building..."
/kaniko/executor --context . --destination docker.io/myuser/app:latest- 如果用
script: >，则所有内容会被折叠成单行，不适合多行命令 - 别在
script块内混用Tab和空格——VSCode默认用空格，设为4空格缩进最稳妥 - 常见报错
Expected a mapping，八成是script:后少了|，或下一行缩进不足2格
如何本地验证Tekton YAML是否真能被Kubernetes接受
VSCode里的Schema校验只是前端提示，不能替代kubectl apply --dry-run=client -f的实际校验。尤其resources字段在Tekton v1beta1中已废弃，但旧Schema可能没更新，容易漏掉。
- 安装
kubectl并配置好集群上下文后，在终端运行：
kubectl apply --dry-run=client -f my-pipeline.yaml -o yaml
- 如果输出渲染后的YAML，说明通过；若报错
error: unable to recognize "my-pipeline.yaml"，大概率是apiVersion写错（比如写成v1alpha1但集群只支持v1beta1） - 配合VSCode任务：在
.vscode/tasks.json里加一个command为kubectl的任务，参数设为["apply","--dry-run=client","-f","${file}"]，按Ctrl+Shift+P→Tasks: Run Task一键验证 - 特别注意：
ServiceAccount、Secret这些依赖资源不包含在Pipeline YAML里，单独校验时不会报错，但运行时会因找不到而失败
真正麻烦的不是写错字段，而是Schema没覆盖到的语义约束——比如Task里resources字段在v1beta1中已移除，但旧版Schema可能还允许它存在，VSCode不报错，kubectl却直接拒绝。
