自定义打包NuGet后缺失staticwebassets文件夹问题排查

一、为什么staticwebassets文件夹丢失？ #

• Azure Pipeline打包时未使用dotnet pack命令，而是用了传统的nuget pack：传统NuGet打包工具不支持Blazor RCL的**静态Web资源（Static Web Assets）**机制，会将wwwroot下的资源默认打包到content/wwwroot目录，而非staticwebassets。
• Pipeline使用的.NET SDK版本过低：Static Web Assets是.NET 5及以上版本引入的特性，若Pipeline中SDK版本低于项目依赖版本，打包逻辑会回退到传统资源打包方式。
• 项目文件配置缺失：RCL项目中未明确指定静态资源的基础路径，导致打包时未触发Static Web Assets的打包规则。

二、修复步骤及正确引用样式的方法 #

1. 修正RCL项目文件配置 #

确保项目文件（.csproj）中包含以下配置：

<Project Sdk="Microsoft.NET.Sdk.Razor">
  <PropertyGroup>
    <TargetFramework>net6.0</TargetFramework> <!-- 或更高版本，如net7.0、net8.0 -->
    <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
    <!-- 指定静态资源的访问前缀，对应消费时的`_content/[PackageId]`路径 -->
    <StaticWebAssetBasePath>_content/$(PackageId)</StaticWebAssetBasePath>
  </PropertyGroup>
</Project>

2. 调整Azure Pipeline的打包命令 #

替换传统的NuGet打包任务，使用dotnet pack命令处理RCL的静态资源：

• 添加DotNetCoreCLI任务执行打包：

- task: DotNetCoreCLI@2
  inputs:
    command: 'pack'
    packagesToPack: '**/shared.razorcomponents.server.csproj'
    configuration: 'Release'
    outputDir: '$(Build.ArtifactStagingDirectory)'

• 先安装对应版本的.NET SDK：

- task: UseDotNet@2
  inputs:
    packageType: 'sdk'
    version: '6.x' # 与项目TargetFramework匹配的版本

3. 验证NuGet包内容（可选） #

在Pipeline中添加步骤检查打包后的nupkg文件，确认staticwebassets目录存在：

- script: |
    7z l $(Build.ArtifactStagingDirectory)/shared.razorcomponents.server.*.nupkg | findstr "staticwebassets"
  displayName: 'Check StaticWebAssets in NuGet package'

4. 消费应用中正确引用样式 #

• 全局样式：在消费应用的_Layout.cshtml（Blazor Server）或index.html（Blazor WASM）中添加：

<link href="_content/shared.razorcomponents.server/css/components.css" rel="stylesheet" />

• 组件隔离样式：无需手动引用，Blazor框架会自动加载_content/shared.razorcomponents.server/shared.razorcomponents.server.bundle.scp.css，只要RCL中的组件使用了.razor.css隔离样式文件即可。

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