VSCode+CodeGeeX快速生成K8s部署文件指南
手写Kubernetes Deployment、Service和Ingress配置时，Spring Boot服务的健康检查端点与端口映射极易遗漏。为此，许多团队采用AI代码补全工具（如CodeGeeX）提升效率：基于手写的骨架（skeleton）和中英文注释，自动生成符合规范的YAML清单。关键在于，必须将运行时约束和校验锚点嵌入提示词中。
接下来，从插件安装到最终验证，逐步拆解完整流程。
安装并启用CodeGeeX插件
在VSCode中按下Ctrl+Shift+X打开扩展市场，搜索CodeGeeX并安装，随后重启编辑器。插件默认采用本地模型推理，无需联网即可响应。首次启动时，它会自动下载约1.2GB的轻量模型缓存至~/.codegeex/models/目录——此过程需耐心等待。
安装成功后，右下角状态栏会显示蓝色⚡ CodeGeeX图标。若图标未出现，请检查是否被其他AI插件（如GitHub Copilot）禁用了语言服务器——两者不兼容，需停用Copilot。
编写精准提示词触发自动生成
新建空白文件并保存为deploy.yaml。必须将语言模式设置为Kubernetes（右下角点击 → Change Language Mode → 输入kubernetes → 回车）。否则CodeGeeX不会加载Kubernetes语义模板，生成内容将偏离预期。
随后，在文件顶部输入以下骨架代码（需保留空行）：
// 生产环境 Spring Boot 3.3 应用配置
apiVersion: apps/v1
kind: Deployment
metadata:
name: user-service
spec:
replicas: 3
selector:
matchLabels:
app: user-service
template:
metadata:
labels:
app: user-service
spec:
containers:
- name: app
image: registry.example.com/user-service:1.0.2
ports:
- containerPort: 8080
livenessProbe:
httpGet:
path: /actuator/health/liveness
port: 8080
readinessProbe:
httpGet:
path: /actuator/health/readiness
port: 8080
resources:
requests:
memory: "512Mi"
cpu: "250m"
将光标置于最后一行末尾，按下Ctrl+Enter调出CodeGeeX补全面板。插件会基于已有结构和注释中的约束（Spring Boot 3.3、/actuator/health/liveness等）续写完整spec，并自动补全Service和Ingress资源块。关键要点：必须先手写skeleton与注释约束，仅凭自然语言描述生成的内容可能跳过健康检查或误用API版本。
校验并修正生成结果
生成后切勿直接apply，需执行三重核对。
第一步：校验YAML合法性。右键文件 → Kubernetes: Validate YAML，检查标红区域。常见错误是CodeGeeX将readinessProbe.path生成为/healthz，而注释中指定了/actuator/health/readiness——发现后手动修正即可。
第二步：确认镜像地址。CodeGeeX默认沿用提示词中的registry.example.com/user-service:1.0.2，需改为私有仓库的真实路径，例如harbor.internal/user-service:v1.2.0。若未修改，kubectl apply后将报ImagePullBackOff错误。
第三步：检查容器端口。确认生成的containerPort与Spring Boot的server.port一致。若application.yml配置了server.port=9001，但生成仍为8080，需同步修改——否则Service流量无法正确转发。
完成上述三项核对后，文件即可提交至GitOps仓库，或执行kubectl apply -f deploy.yaml部署上线。