NuGet Restore未复制配置文件：.NET Standard 2.0包配置文件同步问题

我之前也碰到过一模一样的情况——明明在NuGet包里能看到配置文件乖乖待在dll旁边，可安装到项目里跑起来，bin目录里就只剩dll，配置文件凭空消失了。核心原因是你把配置文件放在了lib目录下，NuGet对lib目录的处理逻辑是只自动引用程序集（.dll/.exe），其他文件不会触发自动复制到输出目录的逻辑。下面给你几个靠谱的解决方案，按推荐程度排序：

方法一：使用contentFiles目录（现代NuGet推荐方式） #

这是NuGet 3.0+引入的标准做法，能完美适配SDK风格项目和多目标框架场景。修改你的包项目csproj中的ItemGroup配置：

<ItemGroup>
  <Content Include="apps.config">
    <Pack>True</Pack>
    <!-- 把文件打包到contentFiles目录，any/any适配所有目标框架和平台 -->
    <PackagePath>contentFiles/any/any</PackagePath>
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <!-- 确保引用项目会自动包含这个文件（不想显示的话可以设为False） -->
    <IncludeInProject>True</IncludeInProject>
  </Content>
</ItemGroup>

重新打包并安装后，配置文件会被自动添加到引用项目中，构建时就会同步复制到bin\Debug目录。如果不想让配置文件出现在引用项目的解决方案资源管理器里，把<IncludeInProject>改成False就行，复制逻辑依然生效。

方法二：使用自定义MSBuild目标（更灵活的控制方式） #

如果需要更精细的控制（比如只在特定环境下复制），可以通过添加MSBuild目标文件来实现：

1. 在你的包项目中创建一个名为[你的包名].targets的文件，内容如下：

<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <Target Name="CopyNuGetAppConfig" BeforeTargets="Build">
    <!-- 从NuGet包的lib目录复制配置文件到项目输出目录 -->
    <Copy 
      SourceFiles="$(MSBuildThisFileDirectory)..\lib\$(TargetFramework)\apps.config"
      DestinationFiles="$(OutputPath)\apps.config"
      SkipUnchangedFiles="True"
      OverwriteReadOnlyFiles="True" />
  </Target>
</Project>

2. 修改包项目的csproj，把这个targets文件打包到build目录（NuGet会自动识别并导入这个目录下的targets文件）：

<ItemGroup>
  <!-- 保留原来的dll和配置文件打包配置 -->
  <None Include="apps.config" Pack="True" PackagePath="lib/$(TargetFramework)">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
  </None>
  <!-- 添加targets文件的打包配置 -->
  <None Include="[你的包名].targets" Pack="True" PackagePath="build" />
</ItemGroup>

重新打包安装后，每次构建引用项目时，这个目标会自动执行，把配置文件复制到输出目录。

补充：为什么原来的配置不生效？ #

再给你捋清楚背后的逻辑：NuGet的lib目录设计初衷是存放可被项目直接引用的程序集，它只会处理.dll、.exe、.pdb这类程序集相关文件，其他类型文件不会触发自动复制到输出目录的逻辑。只有content、contentFiles目录下的文件，或者通过build目录下的MSBuild目标，才能让NuGet处理这些文件的复制行为。

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