应使用 openapi-generator-cli 等跨语言 CLI 工具（依赖 Java 或 Node.js），而非 Python 本身来生成多语言 SDK；Python 仅为生成目标之一，非运行环境。
不能直接在 Python 中“使用 OpenAPI 规范生成多语言 SDK”——Python 是目标语言之一，不是生成工具的运行环境。真正起作用的是 openapi-generator-cli 这类跨语言 CLI 工具，它依赖 Java 或 Node.js 运行时，和你本地有没有 Python 无关。
openapi-generator-cli 安装失败或命令未找到怎么办
这是最常卡住的第一步。很多人误以为 pip install openapi-generator 就能用，但实际没有这个 PyPI 包；官方 CLI 是基于 Java 的可执行 JAR 或 Node.js 包。
- 推荐方式：用 npm 全局安装
@openapitools/openapi-generator-cli（需已装 Node.js ≥18）：npm install -g @openapitools/openapi-generator-cli - 备用方式：下载预编译二进制（GitHub Releases 页面搜
openapi-generator-cli），加到$PATH，验证用openapi-generator version - 常见报错
command not found: openapi-generator：检查是否漏了-g，或 npm 全局 bin 路径没加入 shell 配置（如~/.npm-global/bin） - Java 方式（不推荐新手）：需要 JDK 17+，且
java -jar openapi-generator-cli.jar每次都要写全路径，容易出错
生成 Python SDK 时 import 报错或缺少类型提示
默认生成的 Python 客户端（-g python）结构松散、无 pyproject.toml、不带 __init__.py 层级，IDE 无法识别模块，from myapi.api import DefaultApi 很可能失败。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 必须加
--additional-properties=packageName=myapi,packageVersion=0.1.0，否则生成代码里全是openapi_client这种占位名 - 生成后手动进入输出目录，运行
pip install -e .（前提是目录里有setup.py或pyproject.toml；若没有，用-g python-poetry替代，它会生成 Poetry 标准结构） - 想开箱即用类型提示？别用默认
python模板，改用python-pydantic（支持 Pydantic v2）或python-fastapi（适合服务端调用方） - 注意：生成的
models/下类默认不校验字段必填性，如需强约束，得在生成后手动加Config(extra='forbid')或用--additional-properties=usePydanticV2=true
为什么生成 TypeScript 或 Java SDK 后编译不过
不是模板问题，而是 OpenAPI 源文件本身有缺陷。CLI 不会帮你修复语义错误，只忠实地把 YAML/JSON 映射成代码。
立即学习“Python免费学习笔记（深入）”；
- 典型触发点：
openapi: 3.0.0缺失、components.schemas里用了type: integer却没写format: int64（TS 会生成number，但 Java 可能映射成Integer导致反序列化失败） - 务必先跑验证：
openapi-generator validate -i openapi.yaml，重点看missing required property 'openapi'或schema is invalid类错误 - Java 模板（
-g java）默认生成 OkHttp + Jackson，若项目用 Spring WebFlux，应换-g spring并加--additional-properties=reactive=true,interfaceOnly=true - TypeScript 的
typescript-axios模板默认不导出Configuration实例，要自定义 baseURL 必须手动 new，而typescript-fetch则更轻量但不带默认重试逻辑
最容易被忽略的是：OpenAPI 文件里一个字段标成 nullable: true，但没配 oneOf 或联合类型，Python 生成器就把它当 Optional[str]，TypeScript 却生成 string | null ——表面一致，运行时 JSON 解析行为却可能不同。契约完整性，永远比生成动作本身重要。
