请教NuGet/MSBuild复制NuGet包lib目录至输出目录的具体规则

核心问题 #

在Visual Studio的C# .NET SDK项目中消费NuGet包时，包内lib文件夹的内容会被复制到输出目录，且需按Target Framework分组为lib/TxM/*结构，*.resources.dll文件也有特殊处理。但现有NuGet文档仅零散提及相关规则，无法找到完整的消费规则说明。尤其观察到只有lib/TxM/*.*下的直接文件会被引用，子文件夹会被忽略，请问这背后的确切规则是什么？

确切规则整理 #

结合官方文档信息，消费NuGet包lib目录的核心规则如下：

1. 框架匹配与资源优先级 #

使用PackageReference管理依赖时，NuGet会按以下优先级选择资源：

• 编译资源：优先使用ref/<TFM>/*.dll，若该路径不存在，则回退到lib/<TFM>/*.dll
• 运行时资源：优先使用runtimes/<RID>/lib/<TFM>/*.dll，若该路径不存在，则回退到lib/<TFM>/*.dll

2. lib目录布局强制要求 #

• 必须在lib根目录下创建对应**Target Framework Moniker（TFM）**的子文件夹（如lib/net6.0），禁止将未指定框架的库文件直接放在lib根目录
• TFM子文件夹名称需区分大小写，严格遵循官方TFM命名规范

3. 文件处理与引用规则 #

• lib/<TFM>下的直接文件（包括.dll、.xml、.pdb等）会被自动添加为项目引用，并复制到项目输出目录
• lib/<TFM>下的子文件夹会被忽略，不会被添加为引用，也不会自动复制到输出目录（除非在.nuspec文件中显式配置文件包含规则）
• 命名为*.resources.dll的文件会被视为本地化附属程序集，不会自动添加项目引用，但会按本地化规则复制到输出目录的对应语言子文件夹

4. NuGet版本兼容性 #

多数包的lib目录工作方式与NuGet 2.x保持一致，但扩展了框架名称的可选范围，且框架匹配逻辑更完善。

5. 约定式打包支持 #

遵循上述布局约定时，无需在.nuspec中显式指定文件列表；若需要递归包含lib下所有文件，可在.nuspec的<files>节点中使用通配符：

<file src="lib\**" target="lib/{framework name}[{version}]" />

已收集的信息片段 #

特别说明：有关键描述提到*"对于许多包而言，lib的工作方式与NuGet 2.x中相同"*，若能明确当时/当前规则将十分有帮助。

1. 关于PackageReference资源选择：

使用PackageReference时，NuGet会选择编译和运行时资源。编译资源优先选用ref/<tfm>/*.dll（例如ref/net6.0/*.dll），若不存在则回退至lib/<tfm>/*.dll（例如lib/net6.0/*.dll）。运行时资源优先选用runtimes/<rid>/lib/<tfm>/*.dll，若不存在则回退至lib/<tfm>/*.dll。

2. 关于lib目录兼容性：

Lib：对于许多包而言，lib的工作方式与NuGet 2.x中相同，但扩展了内部可使用的名称选项，且在消费包时选择正确子文件夹的逻辑更完善。

3. 关于程序集引用自动处理：

若遵循《创建包》中描述的约定，则无需在.nuspec文件中显式指定文件列表。当包安装到项目中时，NuGet会自动添加对包内DLL的程序集引用，但排除命名为*.resources.dll的文件，因为它们被视为本地化附属程序集。

4. 关于lib/<TFM>目录内容类型：

lib/{tfm}：对应Target Framework Moniker (TFM)的程序集(.dll)、文档(.xml)和符号(.pdb)文件。

5. 关于多框架布局要求：

需始终在lib下使用区分大小写的不同框架名称创建子文件夹。绝不应将非特定框架版本的库直接放在lib根目录下。若要在构建包时轻松包含所有这些文件，可在.nuspec的<files>部分使用递归通配符**：

<file src="lib\**" target="lib/{framework name}[{version}]" /> 

内容的提问来源于stack exchange，提问作者Martin Ba