如何构建同时包含程序集与JavaScript文件的NuGet包？

一、修正nuspec文件的目录结构配置 #

NuGet对Blazor这类SDK风格Web项目的静态资源，得用contentFiles节点配置才能自动复制，传统content节点可能不生效。给你一个可用的nuspec配置示例：

<?xml version="1.0" encoding="utf-8"?>
<package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">
  <metadata>
    <id>TestClassLibrary</id>
    <version>1.0.1</version>
    <title>Test Class Library for Blazor</title>
    <authors>你的名字</authors>
    <description>带JS工具方法的Blazor类库</description>
    <frameworks>
      <framework targetFramework="net6.0">
        <dependencies>
          <!-- 添加Blazor依赖，版本和.NET 6 LTS匹配即可 -->
          <dependency id="Microsoft.AspNetCore.Components.Web" version="6.0.25" />
        </dependencies>
      </framework>
    </frameworks>
  </metadata>
  <files>
    <!-- 配置程序集文件 -->
    <file src="bin/Release/net6.0/TestClassLibrary.dll" target="lib/net6.0" />
    <file src="bin/Release/net6.0/TestClassLibrary.pdb" target="lib/net6.0" /> <!-- 可选，用于调试 -->
    
    <!-- 核心：配置JS文件，让NuGet自动复制到目标项目 -->
    <file src="wwwroot/js/TestJSUtility.js" target="contentFiles/any/net6.0/wwwroot/js" />
    <!-- 兼容旧项目可加这条（可选） -->
    <file src="wwwroot/js/TestJSUtility.js" target="content/wwwroot/js" />
  </files>
</package>

二、关键配置说明 #

• contentFiles节点：这是SDK风格项目的标准配置，NuGet会自动把该节点下的文件同步到目标项目对应目录。any适配所有平台，net6.0对应你的目标框架。
• 路径对应：要保证src指向你类库项目里JS文件的实际位置（比如类库根目录下的wwwroot/js），target路径要和你期望的目标项目路径完全匹配。

三、验证包结构 #

打包后，你可以解压nupkg文件或者用NuGet包浏览器检查：

• lib/net6.0下要有TestClassLibrary.dll
• contentFiles/any/net6.0/wwwroot/js下要有TestJSUtility.js
• 可选的content/wwwroot/js目录也保留一份JS文件

四、排查安装后未同步的问题 #

如果安装包后JS文件还是没出现在目标项目：

• 确认目标项目是SDK风格（.NET 6默认都是，旧项目得手动开启contentFiles支持）
• 检查打包时用的是Release模式的dll，路径没写错
• 清理目标项目的NuGet缓存，重新安装包

五、可选优化：嵌入JS资源（无需复制文件） #

不想依赖目标项目的wwwroot目录的话，可以把JS文件嵌入程序集，然后调整加载路径：

public async Task<int> AddTwoNumbers(int a, int b)
{
  var assemblyName = typeof(TestClassLibrary).Assembly.GetName().Name;
  await using (IJSObjectReference jsUtility = await _jsRuntime.InvokeAsync<IJSObjectReference>(
    "import", 
    $"./_content/{assemblyName}/js/TestJSUtility.js"))
  {
     int result = await jsUtility.InvokeAsync<int>("simpleAdder", a, b);
     return result;
  }
}

这种方式下，nuspec里JS文件的target路径要改成contentFiles/any/net6.0/_content/TestClassLibrary/js，符合Blazor静态资源的路由规则。

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