Lucene.NET 代码分析器项目的 .NET Standard 兼容性决策

背景介绍

在 Lucene.NET 项目中，有两个专门用于代码分析的特殊项目：Lucene.Net.CodeAnalysis.CSharp 和 Lucene.Net.CodeAnalysis.VisualBasic。这些项目最初被设计为面向 .NET Standard 1.3 版本，以支持包括 Visual Studio 2017 在内的广泛开发环境。

随着 .NET 9 SDK 的发布，微软引入了一个新的警告 NETSDK1215，明确指出不再推荐使用早于 2.0 版本的 .NET Standard。这一变化引发了项目团队对代码分析器目标框架选择的重新评估。

技术评估

在评估是否应该升级目标框架时，团队考虑了以下几个关键因素：

1. 向后兼容性需求：Visual Studio 2017 仍处于扩展支持期，将持续到 2027 年。虽然现代开发环境已普遍支持更高版本的 .NET Standard，但仍有部分用户可能在使用较旧的 IDE 版本。

2. 微软官方建议：微软官方文档明确建议代码分析器项目应面向 .NET Standard 2.0，这为升级提供了理论依据。

3. 实际使用场景：这些代码分析器主要服务于最终用户而非项目内部开发，需要尽可能广泛的兼容性。

4. 维护成本：保持对旧标准的支持虽然会产生警告，但实际维护成本较低，而升级可能带来未知的兼容性问题。

决策过程

经过深入讨论，团队做出了以下决定：

1. 保留 .NET Standard 1.3 目标：为了确保最大程度的兼容性，特别是对 Visual Studio 2017 用户的支持，决定不升级目标框架版本。

2. 抑制警告信息：通过项目配置明确抑制 NETSDK1215 警告，避免构建过程中的干扰，同时添加注释说明保留旧标准版本的原因。

3. 开发环境分析器分离：对于专门用于 Lucene.NET 项目开发的代码分析器，将采用不同的策略，可能包括独立的版本管理和发布流程。

技术实现细节

在实际操作中，团队需要在项目文件中添加以下配置来抑制警告：

<PropertyGroup>
  <NoWarn>$(NoWarn);NETSDK1215</NoWarn>
</PropertyGroup>

同时，团队建议在相关文件中添加清晰的注释，说明保留 .NET Standard 1.3 的原因是为了支持 Visual Studio 2017，并注明微软的扩展支持期限。

未来规划

虽然当前决定保留旧标准支持，但团队将持续关注：

1. Visual Studio 2017 的实际使用情况
2. 社区反馈和需求变化
3. 微软对 .NET Standard 的进一步指导

在 Visual Studio 2017 结束扩展支持后，团队将重新评估升级目标框架的可能性。同时，对于新开发的代码分析功能，将考虑采用更现代的框架版本，并通过适当的架构设计确保兼容性。

这一决策体现了 Lucene.NET 项目对向后兼容性的重视，以及在技术演进和用户需求之间寻求平衡的务实态度。