为PackageReference项目打包net47类库及静态内容到NuGet

我之前帮朋友解决过一模一样的问题，给你一套亲测有效的配置方案，分步骤来搞定静态文件复制到消费项目wwwroot的需求：

NuGet 的 ContentFiles 只是让消费项目“识别”这些静态文件，但不会自动复制到 wwwroot——必须配合自定义构建任务，主动把包内的文件同步到项目目录。

1. 先整理类库的文件结构 #

在你的 Class Library (net47) 项目根目录，创建如下文件夹结构（严格对应，否则NuGet识别不到）：

你的类库项目
├─ contentFiles
│  └─ any
│     └─ net47
│        └─ wwwroot
│           ├─ js
│           │  └─ your-custom-script.js
│           ├─ css
│           │  └─ your-custom-style.css
│           └─ images
│              └─ your-logo.png
├─ build
│  └─ YourPackageId.targets  // 文件名要和你的NuGet包ID一致
└─ YourPackage.nuspec

把所有需要打包的静态文件都放进 contentFiles/any/net47/wwwroot 下的对应子文件夹里；DLL 会由 NuGet 自动打包项目输出文件，不用手动处理。

2. 编写正确的 nuspec 配置 #

把下面的代码复制到你的 nuspec 文件里，替换掉占位符（比如 YourPackageId、版本号等）：

<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">
  <metadata>
    <id>YourPackageId</id>
    <version>1.0.0</version>
    <title>你的包名称</title>
    <authors>你的名字</authors>
    <description>包含类库DLL和MVC静态资源的NuGet包</description>
    <dependencies>
      <group targetFramework=".NETFramework4.7" />
    </dependencies>
    <!-- 声明ContentFiles，告诉NuGet这些静态文件的属性 -->
    <contentFiles>
      <files include="any/net47/wwwroot/**/*" 
             buildAction="Content" 
             copyToOutput="false" 
             flatten="false" />
    </contentFiles>
  </metadata>
  <!-- 打包自定义的Build Target文件 -->
  <files>
    <file src="build\YourPackageId.targets" 
          target="build\net47\YourPackageId.targets" />
  </files>
</package>

关键参数说明： #

• buildAction="Content"：让消费项目把这些文件识别为Content类型
• copyToOutput="false"：不需要复制到项目的输出bin目录，我们要复制到wwwroot
• files节点里的target路径：必须对应build\net47\，确保只在net47框架的项目中生效

3. 编写自定义 MSBuild Target 文件 #

打开 build/YourPackageId.targets，粘贴以下内容——这个任务会在消费项目构建时，主动把包内的静态文件复制到项目的wwwroot目录：

<?xml version="1.0" encoding="utf-8"?>
<Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <!-- 在项目构建前执行文件复制操作 -->
  <Target Name="CopyPackageStaticFilesToWwwroot" BeforeTargets="Build">
    <!-- 定位NuGet包内的所有静态文件 -->
    <ItemGroup>
      <PackageStaticFiles Include="$(MSBuildThisFileDirectory)..\..\contentFiles\any\net47\wwwroot\**\*" />
    </ItemGroup>
    <!-- 递归复制到消费项目的wwwroot，保持原目录结构 -->
    <Copy
      SourceFiles="@(PackageStaticFiles)"
      DestinationFiles="@(PackageStaticFiles->'$(ProjectDir)wwwroot\%(RecursiveDir)%(Filename)%(Extension)')"
      SkipUnchangedFiles="true"
      OverwriteReadOnlyFiles="true"
    />
  </Target>
</Project>

关键逻辑： #

• BeforeTargets="Build"：确保在项目构建前完成复制，避免静态文件缺失
• $(MSBuildThisFileDirectory)：自动获取当前target文件在NuGet包内的路径，不用硬编码
• SkipUnchangedFiles="true"：只复制修改过的文件，提升构建效率

4. 打包并测试 #

1. 先清理并构建你的类库项目（Release模式）
2. 打开命令行，进入类库项目根目录，执行打包命令：

   nuget pack YourPackage.nuspec -Properties Configuration=Release
   

3. 在你的MVC消费项目中，添加这个本地NuGet包（可以把生成的.nupkg文件放到本地NuGet源目录）
4. 构建消费项目，打开项目的wwwroot目录，就能看到复制过来的js、css和图片了！

避坑提醒： #

• 不要把contentFiles或build文件夹的“复制到输出目录”设为“始终复制”——NuGet会通过nuspec打包这些文件，不需要输出到类库的bin目录
• 如果消费项目已有同名文件，OverwriteReadOnlyFiles="true"会强制覆盖，可根据需求调整这个参数
• 确保你的NuGet包ID和target文件名完全一致，否则MSBuild找不到自定义任务

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