在Razor类库(RCL)中如何嵌入构建时生成的assemblyName.styles.css文件？

我完全懂你的困扰——直接尝试嵌入那个还没生成的打包CSS文件肯定会失败，因为MSBuild的嵌入资源步骤在scoped CSS的打包任务之前就执行了，这时候assemblyName.styles.css还没被创建出来。而且直接嵌入原始的.razor.css文件又会丢失编译器自动添加的作用域选择器，完全违背了用scoped CSS的初衷。

解决这个问题的关键是调整MSBuild的任务执行顺序，确保我们在scoped CSS打包完成后，再把生成的.styles.css文件添加为嵌入资源。下面是具体的实现步骤：

1. 保留原有嵌入wwwroot资源的配置 #

首先，继续保留你原来用于嵌入wwwroot静态资源的配置，这部分没问题：

<PropertyGroup>
  <GenerateEmbeddedFilesManifest>true</GenerateEmbeddedFilesManifest>
</PropertyGroup>

<ItemGroup>
  <EmbeddedResource Include="wwwroot\**" />
</ItemGroup>

<ItemGroup>
  <PackageReference Include="Microsoft.Extensions.FileProviders.Embedded" Version="7.0.5" />
</ItemGroup>

2. 添加自定义MSBuild目标，延迟嵌入打包后的CSS #

在你的RCL项目的.csproj文件末尾，添加一个自定义的MSBuild目标，这个目标会在scoped CSS打包任务完成后执行：

<Target Name="EmbedScopedCssBundle" AfterTargets="ScopedCssBundler">
  <!-- 定义打包后scoped CSS文件的路径 -->
  <PropertyGroup>
    <ScopedCssBundlePath>$(IntermediateOutputPath)scopedcss\bundle\$(AssemblyName).styles.css</ScopedCssBundlePath>
  </PropertyGroup>

  <!-- 只有当文件存在时，才将其添加为嵌入资源 -->
  <ItemGroup>
    <EmbeddedResource Include="$(ScopedCssBundlePath)" Condition="Exists('$(ScopedCssBundlePath)')">
      <!-- 设置逻辑名称，让它和wwwroot下的资源路径保持一致，方便后续访问 -->
      <LogicalName>wwwroot\$(AssemblyName).styles.css</LogicalName>
      <!-- 不需要复制到输出目录，因为已经嵌入到DLL中了 -->
      <CopyToOutputDirectory>Never</CopyToOutputDirectory>
    </EmbeddedResource>
  </ItemGroup>
</Target>

关键细节解释 #

• AfterTargets="ScopedCssBundler"：这个属性是核心，它告诉MSBuild要等ScopedCssBundler任务（也就是生成assemblyName.styles.css的任务）完成后，再执行我们的嵌入操作，这时候目标文件已经存在了。
• Condition="Exists('$(ScopedCssBundlePath)')"：做个安全检查，避免因为打包失败导致的构建错误。
• LogicalName：把嵌入资源的逻辑路径设置为wwwroot\$(AssemblyName).styles.css，这样当你在宿主应用中使用嵌入式文件提供者时，能和常规的wwwroot资源路径无缝衔接。

3. 验证嵌入结果 #

构建你的RCL项目后，可以用ILSpy、dnSpy这类工具打开生成的DLL，查看“资源”节点下是否存在wwwroot\你的程序集名称.styles.css文件，确认它已经被成功嵌入。

宿主应用中使用嵌入式资源 #

最后，在引用这个RCL的宿主应用中，别忘了配置嵌入式文件提供者，比如在Program.cs中：

builder.Services.AddRazorComponents()
    .AddInteractiveServerComponents()
    // 替换成你的RCL项目的命名空间
    .AddEmbeddedComponents<YourRCLNamespace._Imports>();

这样就能确保宿主应用正确加载到你嵌入的scoped CSS资源了。

备注：内容来源于stack exchange，提问作者tyrrr