Chimney项目2.0.0-M1版本发布：迈向Scala 3 LTS的重要里程碑

Chimney是一个强大的Scala库，专注于简化对象之间的转换过程。它通过提供类型安全的转换机制，帮助开发者避免手动编写大量样板代码，特别适用于领域对象与DTO之间的转换场景。

版本背景与核心变更

2.0.0-M1版本是Chimney项目面向未来的重要里程碑，主要为了解决Scala 3.7.0版本中given解析优先级变更带来的兼容性问题。这个版本进行了多项架构调整，为最终支持Scala 3 LTS版本奠定了基础。

架构重构

项目团队将chimney-macro-commons模块分离到独立仓库，这一决策带来了几个显著优势：

1. 解耦了核心逻辑与宏实现的版本依赖
2. 允许独立演进宏公共组件
3. 减少了未来版本升级的破坏性影响

API清理与优化

新版本对API进行了精心梳理：

• 移除了长期标记为废弃的withCoproduct方法
• 统一了结果转换方法，推荐使用.asResult替代旧的.toPartialResult
• 重构了内部类型级配置表示，提升了类型安全性
• 修正了Protobuf支持特性中的命名拼写错误
• 增强了对Google Protobuf类型的支持，使其能够作为完全可构建的迭代集合

技术实现细节

解决Scala 3.7.0兼容性问题

新版本彻底重构了given实例的提供方式，避免了之前依赖的隐式解析模式。这种模式在Scala 3.7.0中由于given优先级调整而失效。重构后的实现更加健壮，能够适应未来的语言变化。

类型系统改进

内部类型级配置表示的重构是本次版本的重要技术升级。虽然这些类型主要供库内部使用，但它们的公开可见性要求设计必须严谨。新设计提供了：

• 更清晰的类型边界
• 更好的编译时错误信息
• 更灵活的扩展能力

集合处理增强

对Protobuf的ByteString和ByteValue类型的支持从简单的底层类型转换升级为TotallyBuildIterable特性，这意味着：

• 支持更丰富的集合操作
• 保持与Scala集合生态的无缝集成
• 提供更自然的API体验

升级建议

对于现有用户，升级到2.0.0-M1版本需要注意：

1. 检查是否使用了已移除的废弃API
2. 评估项目对Scala版本的兼容性要求
3. 测试关键转换逻辑，特别是涉及复杂类型和集合的场景

这个里程碑版本虽然包含破坏性变更，但为项目的长期稳定发展奠定了坚实基础。团队承诺在稳定版本上继续提供bug修复，同时逐步完善2.0.0系列，直到正式发布。

未来展望

随着这一架构调整的完成，Chimney项目将能够：

• 更灵活地适应Scala语言演进
• 降低未来重大变更的影响范围
• 加速新特性的开发和交付

对于需要长期稳定支持的企业级应用，等待2.0.0正式版发布后再进行评估升级是较为稳妥的策略。而对于愿意参与早期体验的团队，这个里程碑版本提供了预览未来技术方向的机会。