NuGet导入DLL无法设置Copy Always，.targets文件不生效求助

问题描述 #

• 开发的类库通过NuGet包发布并导入到其他项目后，目标项目中该类库DLL的Copy to Output Directory属性始终被设为Do not copy；手动修改为Copy Always后，更新NuGet包又会被重置回默认值
• 尝试创建.targets文件固定属性但未生效：
  • nuspec已将.targets文件打包到Build目录，解压nupkg可确认文件存在
  • 先后尝试用<None>和<Content>节点配置.targets，均无效果
  • 目标项目的.csproj仅生成<Content Include="Assets\Devices\MyProj.Devices.Test.NugetTesting.dll" />节点，缺少预期的<CopyToOutputDirectory>Always</CopyToOutputDirectory>配置
  • VS还原包时日志无.targets文件相关加载记录

解决方案 #

1. 确保.targets文件的命名与路径合规 #

NuGet的.targets文件必须与包ID同名，并且放置在nupkg的build目录下（如果是多目标框架项目，需放在build\{TargetFramework}子目录，比如build\net6.0）。

示例：若包ID为MyProj.Devices.Test.NugetTesting，则.targets文件名必须是MyProj.Devices.Test.NugetTesting.targets。

2. 编写正确的.targets配置 #

不要直接用<Content>或<None>重新定义文件，而是通过<Update>节点修改已导入文件的属性，或者明确指定文件的复制规则：

方案A：修改已导入DLL的属性

如果DLL已被作为Content导入到目标项目，用<Update>节点覆盖复制属性：

<Project>
  <ItemGroup>
    <Content Update="Assets\Devices\MyProj.Devices.Test.NugetTesting.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
    </Content>
  </ItemGroup>
</Project>

方案B：直接定义文件并设置属性

如果DLL未被自动导入，直接用<Content>节点添加并配置复制规则：

<Project>
  <ItemGroup>
    <Content Include="Assets\Devices\MyProj.Devices.Test.NugetTesting.dll">
      <CopyToOutputDirectory>Always</CopyToOutputDirectory>
      <PackagePath>content\Assets\Devices\MyProj.Devices.Test.NugetTesting.dll</PackagePath>
    </Content>
  </ItemGroup>
</Project>

3. 修正nuspec打包配置 #

确保nuspec中正确包含DLL和.targets文件的打包规则：

<package>
  <metadata>
    <id>MyProj.Devices.Test.NugetTesting</id>
    <version>1.0.0</version>
    <!-- 其他元数据（名称、作者等） -->
  </metadata>
  <files>
    <!-- 将DLL打包到content目录，确保目标项目能自动导入到对应路径 -->
    <file src="bin\Release\net6.0\MyProj.Devices.Test.NugetTesting.dll" target="content\Assets\Devices" />
    <!-- 将.targets文件打包到build目录 -->
    <file src="build\MyProj.Devices.Test.NugetTesting.targets" target="build" />
    <!-- 多目标框架项目使用以下路径 -->
    <!-- <file src="build\net6.0\MyProj.Devices.Test.NugetTesting.targets" target="build\net6.0" /> -->
  </files>
</package>

4. 验证VS还原与项目配置 #

• 清理目标项目的obj和bin目录，重新执行NuGet包还原
• 查看目标项目的.csproj文件，确认是否自动引入了.targets文件（VS会自动添加类似<Import Project="..\packages\MyProj.Devices.Test.NugetTesting.1.0.0\build\MyProj.Devices.Test.NugetTesting.targets" Condition="Exists('..\packages\MyProj.Devices.Test.NugetTesting.1.0.0\build\MyProj.Devices.Test.NugetTesting.targets')" />的节点）
• 检查DLL的属性面板，确认Copy to Output Directory已设为Copy Always

5. 备选方案：直接修改目标项目的PackageReference配置 #

如果使用PackageReference格式的NuGet引用，可跳过修改NuGet包，直接在目标项目的.csproj中添加配置：

<ItemGroup>
  <PackageReference Include="MyProj.Devices.Test.NugetTesting" Version="1.0.0">
    <PrivateAssets>all</PrivateAssets>
    <CopyToOutput>true</CopyToOutput>
  </PackageReference>
</ItemGroup>

该配置会强制将包的输出文件复制到目标项目的输出目录，不受包更新影响。

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