必须依赖标准化openapi规范文件作为唯一输入源，需先验证openapi: "3.0.3"字段存在及语法完整性，再用cli逐语言或批量生成java、python、typescript、go、c#等50余种sdk，并分别验证各语言编译与导入可用性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在CodeBuddy中完成接口调试并确保生成的客户端代码覆盖Java、Python、TypeScript、Go、C#等50多种主流语言，必须依赖标准化的OpenAPI规范文件作为唯一输入源，不能靠手动补全或猜测语言特性。
准备合法有效的OpenAPI文档
第一步：确认你的接口描述文件是符合OpenAPI 3.0+规范的YAML或JSON格式，文件开头必须包含【openapi: "3.0.3"】字段，否则后续所有语言生成都会失败——OpenAPI Generator会直接报错“missing required field 'openapi'”，且不提示具体缺失位置。
第二步：用官方校验工具检查语法和语义完整性。执行openapi-generator validate -i openapi.yaml，重点看是否有$ref循环引用、schema类型冲突或required字段缺失。这一步跳过会导致生成的Go客户端编译失败，Python客户端缺少模型字段。
第三步：把校验通过的文件保存为openapi.yaml（推荐）或openapi.json，放在项目根目录下，路径中不要含中文或空格——某些Windows环境下的CLI版本会因路径编码问题静默跳过生成步骤。
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
用OpenAPI Generator CLI批量生成多语言SDK
方法一：逐语言生成（适合调试单个语言行为）
执行openapi-generator generate -i openapi.yaml -g java -o ./java-sdk → 生成标准Maven结构，含ApiClient、model、api三个包；
执行openapi-generator generate -i openapi.yaml -g typescript-axios -o ./ts-sdk → 输出index.ts作为入口，自动处理Promise链与错误类型；
执行openapi-generator generate -i openapi.yaml -g python -o ./py-sdk → 生成可pip install -e .本地安装的包，含models/apis/configuration模块。
方法二：一键生成全部支持语言（需提前查表）
OpenAPI Generator官网列出的50+语言中，真正稳定可用的约38种。运行openapi-generator list查看当前CLI版本支持的generator列表，过滤掉标记为(beta)或(experimental)的条目——比如dart和rust虽在列表里，但2026年7月最新版仍存在path参数解析错误，生成后需手动修正。
方法三：用配置文件驱动批量生成（推荐用于CI/CD）
创建generate-config.yaml，写入目标语言、输出路径、包名等参数；
执行openapi-generator generate -c generate-config.yaml -i openapi.yaml；
该方式能复用同一份配置生成Java + TypeScript + Python + C#四套SDK，避免重复指定-g参数出错。
验证各语言SDK是否真正可用
第一步：进入./java-sdk目录 → 运行mvn compile，确认无编译错误且所有API类被正确识别；
第二步：打开./ts-sdk/src/index.ts → 检查是否导出DefaultApi类及getXXX方法签名，若只有any类型说明schema定义缺失required字段；
第三步：进入./py-sdk → 执行python -c "import openapi_client; print(openapi_client.__version__)"，成功打印版本号即表示包结构正确；
第四步：对Go语言SDK特别处理 → 进入./go-sdk → 运行go mod init example.com/sdk → 再执行go build ./...，Go模块路径必须与go.mod中声明一致，否则import语句全部报错。
