Nuget Pack 不支持程序集版本上的位数

I need nuget pack生成只有 3 位数字的包版本（我们想对其进行语义版本控制），但是当我在具有AssemblyVersion属性设置为“1.0.0”，生成的 nupkg 文件在其元数据（和文件名）中以版本“1.0.0.0”结尾。为什么命令行工具不支持指定的位数AssemblyVersion属性？

我首先打电话给nuget spec针对 csproj 文件，该文件生成一个像这样的存根 nuspec 文件（它实际上包含更多带有占位符值的标签，但我已经删除了它们，因为我们不需要它们）：

<?xml version="1.0"?>
<package >
  <metadata>
    <id>$id$</id>
    <version>$version$</version>
    <title>$title$</title>
    <authors>$author$</authors>
    <owners>$author$</owners>
    <requireLicenseAcceptance>false</requireLicenseAcceptance>
    <description>$description$</description>
    <releaseNotes>Release notes.</releaseNotes>
    <copyright>Copyright 2015</copyright>
  </metadata>
</package>

将这个 nuspec 文件签入 TFS 中与 csproj 文件相同的文件夹中后，我们现在可以像这样调用 pack：

nuget pack MyProject.csproj

项目的 AssemblyInfo.cs 文件包含一行用于显式设置版本：

[assembly: AssemblyVersion("1.0.0")]

除了该工具在检索程序集版本时使用 4 位数字之外，一切都工作得很好。当我右键单击文件资源管理器上的 dll 并转到详细信息时，即使 Windows 也仅显示 3 位数字的版本。为什么 NuGet 使用 4 位数字？我是否遗漏了一些明显的东西？

对 nuspec 中的版本进行硬编码显然并不理想，因为这样我们就必须在两个不同的位置维护版本号，而它们的目的是始终相同。我的意思是，这应该是特殊占位符值背后的想法$version$NuGet 本身知道如何从项目中提取。

In the 创建和发布包 http://docs.nuget.org/Create/Creating-and-Publishing-a-Package据说 NuGet 使用AssemblyVersionAttribute令牌时的属性$version$用来。
深入研究 NuGet 源代码，我发现它并不像人们想象的那么简单。

NuGet 使用反射来获取库的版本。AssemblyName.Version准确地说。由于版本的所有组成部分都必须是大于或等于零的整数（请参阅程序集名称.版本 https://msdn.microsoft.com/en-us/library/system.reflection.assemblyname.version%28v=vs.110%29.aspx#Remarks），提供的版本是 1.0.0.0 （在您的情况下）而不是您中声明的 1.0.0AssemblyVersion属性。

可能的解决方案
The 核规格参考 http://docs.nuget.org/Create/Nuspec-Reference页面旁边添加了更多信息$version$令牌。它提到AssemblyInformationalVersionAttribute属性将优先于AssemblyVersionAttribute。使用它会解决您的问题。

深层发掘
你可能想知道为什么会AssemblyInformationalVersionAttribute工作和AssemblyVersionAttribute won't?

这个问题的答案是 NuGet 使用CustomAttributeData.GetCustomAttributes(Assembly)函数在使用 Assembly.Version 之前检索库的属性。上面的函数就不一一列举了AssemblyVersionAttribute，但它会列出AssemblyInformationalVersionAttribute如果它被用在组件上。 只有这样，如果未找到 AssemblyInformationalVersionAttribute，才会使用 Assembly.Version。

EDIT:
相关NuGet源代码：
NuGet 使用以下代码获取程序集版本（如果未找到 AssemblyInformationalVersionAttribute）：

Assembly assembly = Assembly.ReflectionOnlyLoadFrom(path);
AssemblyName assemblyName = assembly.GetName();
...
version = new SemanticVersion(assemblyName.Version);

问题始于 assembly.GetName()，因为它使用相关参数（包括版本）创建并初始化 AssemblyName。
（该代码可以在程序集元数据提取器 http://nuget.codeplex.com/SourceControl/latest#src/Core/Authoring/AssemblyMetadataExtractor.cs类，下public AssemblyMetadata GetMetadata(string path)功能。）