你们是把***全塞进类名里了吗?某大厂 Python SDK 的命名问题

265 字
1 分钟
你们是把***全塞进类名里了吗?某大厂 Python SDK 的命名问题

TransitRouterBandwidthPackageForDescribeTransitRouterBandwidthPackagesOutput

这是火山引擎 Python SDK 的一个类名。一个类名里塞进产品、资源、接口、用途和输出方向,生怕少写一个词就无法表达完整。

Issue #54 中展示的超长 SDK 目录与类型名
Issue #54 中展示的超长 SDK 目录与类型名

Issue #54 指出,这套命名和目录结构已经长到会碰 Windows 路径长度限制;用户安装 SDK,还得操心系统长路径配置。云服务 SDK 做到让用户研究注册表,属实有点开发者为难开发者。

这不是 Python 的问题。是生成代码没有经过公共 API 设计:把内部 schema、operation 名和响应类型一股脑拼接,生成器输出什么,就喂给用户什么。

更有节目效果的是,维护方回复重点是“全产品总包体积较大,后续考虑按需分包”,然后关闭了 issue。用户问的是类名和路径,维护方回答的是包体积。问题没回答,issue 先关了。

这样的 SDK 设计,实在是无力吐槽。

文章分享

如果这篇文章对你有帮助,欢迎分享给更多人!

你们是把***全塞进类名里了吗?某大厂 Python SDK 的命名问题
https://blog.qiui.net/posts/2026-07-21-volcengine-python-sdk-naming/
作者
Qiui
发布于
2026-07-21
许可协议
CC BY-NC-SA 4.0

评论区

文章目录