是什么导致 NuGet 将包还原到略有不同的文件夹结构？

Question

Visual Studio 2019

我有一个.NET Core 解决方案，它需要引用单个.NET Framework 包，只是为了将包内容扩展到packages 文件夹，以便可以使用一些工具。

在我的.csproj 我有这行：

<PackageReference Include="roundhouse" Version="1.1.0" TargetFramework="net472" />

我发现当我构建我的解决方案（在本地开发人员Visual Studio 或TeamCity 中）时，有时NuGet 会将我的包恢复到这个文件夹结构：

\packages\roundhouse.1.1.0\roundhouse.1.1.0.nupkg

这就是它目前正在做的事情。

但是在另一台开发机器上（以及在TeamCity Build Agent 上），构建会创建这个文件夹结构：

\packages\roundhouse\1.1.0\roundhouse.1.1.0.nupkg

注意细微差别。

我无法弄清楚可能导致这些不同的行为。我找不到任何与NuGet 包文件夹结构相关的配置设置。

有人知道吗？

Answer 1

我找不到任何控制哪个文件夹结构的配置设置 被使用了。

我认为这种行为与 nuget 包格式 packages.config 和 PackagesReference 有关。

全局包文件夹(%userprofile%\.nuget\packages ) 是 NuGet 安装任何下载包的位置。每个包都完全展开到与包标识符和版本号匹配的子文件夹中。使用 PackageReference 格式的项目始终直接使用此文件夹中的包。使用 packages.config 时，包会安装到 global-packages 文件夹，然后复制到项目的 packages 文件夹中。来自here的提示。

结论

使用PackageReference时，全局包文件夹中的nuget路径类似于结构2。

\packages\roundhouse\1.1.0\roundhouse.1.1.0.nupkg

此外，从 global-packages 文件夹复制的解决方案中的包已更改为结构 1 的路径。

\packages\roundhouse.1.1.0\roundhouse.1.1.0.nupkg

当您使用 package.config 格式时，Nuget 会出于某些特定原因修改从 global-packages 文件夹复制到解决方案的 nuget 的路径。

这只是 package.config 和 PackagesReference 的正常行为，它就是这样设计的。

更新1：

我发现你在一个核心项目的 xxx.csproj 中添加了<PackageReference Include="roundhouse" Version="1.1.0" TargetFramework="net472" />。这种格式就像框架项目的 packages.config 中的内容。我猜你只是将packages.config中的内容复制到核心项目的xxx.csproj中，尽管你使用了packageReference。另外，TargetFramework="net472"表示会在framework4.7.2上安装包，所以不会出现在核心项目中。

我做过这些测试；

1) 带有 packages.config 的框架项目

packages.config

xxx.csproj

它加载packages.config来加载nuget包

2) 带有 PackageReference 的框架项目

xxx.csproj

3)核心项目

所以我认为是您导入 nuget 包的方式导致了这种奇怪的行为。并且请不要在核心项目（PackageReference）中使用像TargetFramework="net472"这样的packages.config格式。如果您确保在解决方案中的所有项目中都使用PackageReference，您可以尝试以下步骤：

解决方案：

1) 清理 nuget 缓存

2) 更改您在 xxx.csproj 中的初始参考格式，例如

<ItemGroup>
    <PackageReference Include="roundhouse" Version="1.1.0" />
</ItemGroup>

然后你可以看看恢复路径是否不同。

希望对你有帮助。