Fern项目中TypeScript生成器保留原始字段大小写的功能解析

在API开发领域，保持前后端数据格式的一致性至关重要。Fern作为一款API定义工具，其TypeScript生成器提供了一个鲜为人知但十分实用的功能——retainOriginalCasing（保留原始字段大小写），这个功能在最新文档中已得到补充。

功能背景

当开发者使用OpenAPI规范定义接口时，常见的字段命名习惯是使用蛇形命名法（如display_name）。然而在TypeScript/JavaScript生态中，更普遍的约定是采用驼峰命名法（displayName）。这种差异可能导致前后端协作时的理解成本。

技术实现原理

retainOriginalCasing参数允许开发者控制生成器是否自动转换字段命名风格：

• 当设置为false（默认值）时，生成器会自动将蛇形命名转换为驼峰命名
• 当设置为true时，则保留原始API定义中的字段命名方式

典型应用场景

1. 遗留系统集成：对接已存在的老系统时保持字段一致性
2. 严格规范要求：某些企业要求严格遵循特定的命名规范
3. 多语言协作：当团队混合使用不同编程语言时减少认知负担

最佳实践建议

虽然保留原始大小写可以减少转换成本，但建议：

1. 新项目统一采用驼峰命名以符合TypeScript社区惯例
2. 混合使用时注意在接口文档中明确标注命名规范
3. 在DTO转换层处理命名差异，保持业务逻辑代码的一致性

该功能的加入体现了Fern对实际开发场景的深入理解，为开发者提供了更灵活的代码生成选择。