github.com/jinzhu/gorm与gorm.io/gorm的区别是什么？该如何选择？

核心差异对比 #

• 版本定位与维护状态差异
  • github.com/jinzhu/gorm 是Gorm v1代版本，目前已经进入停止维护的归档状态，最后一次功能/安全更新停留在2020年，不会再接收新的特性请求、漏洞补丁，已发现的安全类问题不会得到官方修复，存在长期运行的安全隐患。
  • gorm.io/gorm 是Gorm v2代版本，为当前官方活跃维护的主线版本，持续跟进Go语言版本兼容、安全漏洞修复、主流数据库驱动的能力适配。
• 功能能力差异
  • v1版本缺乏原生的context.Context上下文透传能力，实现请求超时控制、分布式链路追踪需要额外做逻辑改造，且链式调用逻辑、事务处理、软删除实现存在较多遗留边界bug。
  • v2版本从底层设计上全链路支持上下文传参，重构了链式调用的状态管理逻辑，完善了嵌套事务、批量操作、Schema迁移的能力，可靠性更高，也更适配云原生场景的可观测性要求。
• 生态适配差异
  • 当前所有官方数据库驱动、社区开发的Gorm生态插件、最佳实践文档均围绕v2版本搭建，v1版本已无新的生态支持，遇到定制化需求很难找到现成的解决方案。

选型建议 #

• 所有新启动的Go业务开发场景，必须优先选用gorm.io/gorm依赖，避免使用停更的v1版本埋下长期维护风险。
• 接手历史遗留项目时，若项目已经引入github.com/jinzhu/gorm，可先保持现有逻辑稳定运行，但需要排期规划版本迁移，逐步切换到v2版本，降低后续维护成本。

注意：不要混用两个版本的依赖，二者API设计差异较大，混用时会出现类型不匹配、行为异常的问题。

内容的提问来源于stack exchange，提问作者Alain Sst