在.NET中使用PgVector构建向量搜索,开发者指南
.NET 10 于2025年11月作为长期支持版本发布,支持至2028年11月。如果您还在使用.NET 8 或.NET 9,有个值得在日历上标记的日期:二者的支持将在2026年11月结束。这就是为什么现在应该开始计划迁移的实际原因,否则应用程序底层的运行时将不再收到安全和质量更新。
这是我们想在前期坦诚相待的一部分。 对于大多数团队来说,升级本身并不是最困难的部分。
我们开发和维护面向从.NET Framework 4.6.2到.NET 10的文档处理库,所以我们从内部看到了很多这样的升级。在多数情况下,当您从一个受支持的.NET版本迁移到下一个版本时,IronPDF、IronXL、IronOCR、IronWord及套件其余部分在没有任何代码更改的情况下继续正常工作。 您更改目标框架,恢复包,您的PDF仍然渲染,您的电子表格仍然处理,您的OCR仍然运行,您的Word 文档仍然生成。
所以如果消息只是"升级到.NET 10并从我们这里购买支持",诚实的开发者反应会是:为什么? 库应该已经在工作。 这很公平。
更有用的讨论是关于兼容性和优化的区别,以及为什么即使没有问题,持续的产品更新也很重要。
兼容性和优化不是一回事
当微软发布新的.NET版本时,库支持通常分两个阶段到来。
第一个阶段是兼容性。 库在新的运行时上正确工作。您的应用程序编译、运行、生成文档,行为如预期。 这是基线,对于Iron套件而言,它已经到位。 Iron Software的当前包直接针对.NET 10以及更早的运行时。
第二个阶段是优化。 新的.NET版本带来真正的性能和内存改进,特别是.NET 10聚焦于运行时:更好的JIT内联和去虚拟化、更多的堆栈分配、改进的循环优化和更广泛的硬件指令支持。 一个库可以在首日完全兼容,同时仍有工程余地在后续的版本中充分利用这些收益。 兼容性意味着它可用。 优化意味着它工作得更好,而且这项工作在初始版本发布后会持续下去。
为什么产品更新重要,即使没有问题
平台不会停止变化于.NET版本发布的那一刻。 运行时服务更新、依赖项变化、云平台更新、ARM64 的进展和容器基础镜像的变化都在持续到来。 您的安装版本可能在绝大部分情况下都能正常工作。 保持在当前产品更新的价值在于,当平台在您之下发生变化时,解决方案已经准备就绪。
从我们自己的更改日志中一个具体的例子:最近的IronPDF版本修正了在Linux和Docker环境中的依赖自动配置,以便在Ubuntu 24.04上的.NET 9 和.NET 10 环境中安装正确的音频库libasound2t64。 您的代码没有引起那种改变。 基础镜像和运行时组合发生了变化,兼容性更新在后续补丁中发布。 这就是微型模式:平台在演变,持续的产品发布携带调整,使其永远不会成为生产事故。
更改目标框架,移动到当前包版本,恢复,完成。
如果您想确认自己的工作流程中这一点,最简单的方法是直接测试。 您可以从NuGet获取最新的IronPDF或套件中的任何库,并在承诺迁移之前使用免费的试用密钥在.NET 10上运行您现有的文档代码。 这是将"应该能用"变成"确实能用"的最快方法,适用于您的特定代码库。
支持的实际作用
支持并不是针对"如何从.NET 8升级到.NET 10"的问题。微软自己的迁移指导对此有详细的说明,而我们更愿意指引您参考这些指导,而不是假装知晓答案。
当迁移后某些东西没有正常工作时,支持就显得尤为重要。 特定运行时的异常、部署和容器的差异、平台特定的不兼容性、意外的渲染差异以及环境特定的回归都是保持支持关系的重要原因。 在这些情况下,我们可以调查问题,提供解决方法,提升真正的兼容性问题,并在未来的发布中提供修复。
迁移的实用步骤
如果您计划迁移到.NET 10,建议的操作顺序是:
- 提前测试,基于真实构建而不是示例项目。
- 验证每个文档工作流,而不仅仅是常用路径。
- 检查您的部署目标:Docker、Linux、Azure和ARM64。
- 随时保持库的最新版本,而不是将它们批量更新。
- 如果您关注向前运行业务兼容性,请保持产品更新。
结语
大多数 .NET 迁移是平稳无事的,这就是重点所在。 保持最新的价值并不是说您的应用程序在.NET 10到来时会立即崩溃。 而是随着平台的不断发展,您有兼容性更新、修复和持续的工程工作,这些可以让您的文档处理栈平稳运行,而不是变成您需要解决的问题。
