CSharpier项目中移除版本号哈希值的解决方案

在CSharpier项目中，开发者遇到了一个关于版本号显示的问题。默认情况下，.NET项目构建时会自动在版本信息中包含源代码的Git哈希值，这会导致生成的版本号看起来像"1.0.0+abc123"这样的格式。

问题背景

在.NET项目的构建过程中，默认行为是将Git仓库的提交哈希值附加到版本号后面。这种设计初衷是为了帮助开发者快速识别构建版本对应的源代码状态。然而，在某些情况下，开发者可能希望获得更简洁的版本号格式，而不包含哈希值部分。

解决方案

通过深入研究.NET项目的构建系统，我们发现可以通过修改项目文件(.csproj)中的特定属性来控制这一行为。具体来说，在项目文件中添加以下配置即可禁用哈希值的自动附加：

<PropertyGroup>
  <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
</PropertyGroup>

技术原理

这个解决方案利用了.NET SDK内置的版本控制机制。IncludeSourceRevisionInInformationalVersion是一个MSBuild属性，它控制着是否将源代码控制信息(如Git提交哈希)包含在程序集的InformationalVersion属性中。

当设置为false时，构建系统将不会在版本号后面附加哈希值，从而产生更简洁的版本号格式。这在需要发布正式版本或需要严格控制版本号格式的场景下特别有用。

实际应用

在CSharpier项目中，开发者通过提交7dc9d84和12ece65实现了这一变更。这种修改不仅简化了版本号的显示，还保持了版本控制的清晰性，因为Git提交信息仍然可以通过其他方式追踪。

总结

对于.NET开发者来说，理解如何控制版本号的生成方式是一个重要的技能。通过合理配置项目文件，我们可以灵活地控制版本信息的展示方式，既可以在开发阶段保留详细的构建信息，也可以在发布版本时保持版本号的简洁性。CSharpier项目的这一实践为其他.NET项目提供了很好的参考。