Blazor 怎么将 Razor Class Library (RCL) 用作组件库

Blazor中RCL作为组件库的核心是隔离、正确引用和静态资源处理：创建无宿主依赖的Razor组件，通过项目引用并在\_Imports.razor中导入命名空间；静态资源放入RCL的wwwroot，构建时自动复制至\_content/{RCLName}/路径。

Blazor 中将 Razor Class Library（RCL）用作组件库，核心是：创建可复用的、无宿主依赖的 Razor 组件，并在主项目中正确引用和使用。关键不在于“打包”，而在于“隔离 + 正确引用 + 静态资源处理”。

创建 RCL 并组织组件

在解决方案中新建 Razor Class Library 项目（.NET 6+ 推荐选“支持 ASP.NET Core Shared Framework”）。默认会包含 _Imports.razor，可在此统一导入常用命名空间（如 @using Microsoft.AspNetCore.Components.Web），方便下游直接使用组件而无需重复 @using。

把自定义组件（`.razor` 文件）放在 `Components/` 目录下（非必须，但推荐），例如：Alert.razor、Card.razor。避免在 RCL 中依赖 `Program.cs` 或 `App.razor` 等宿主特有逻辑——它只提供 UI 块，不启动应用。

• 组件内若用到 CSS 或 JS，建议用 Scoped CSS（.razor.css），自动作用域隔离，避免样式污染
• 如需全局 JS，不要在 RCL 中调用 IJSRuntime 初始化；留待主项目按需注入或加载
• 若组件需参数，用 [Parameter] 显式声明，保持接口清晰

在 Blazor WebAssembly 或 Server 项目中引用 RCL

右键主项目 → “添加项目引用” → 选中你的 RCL 项目。或者用 CLI：dotnet add reference ../MyComponentLib/MyComponentLib.csproj。

引用后，RCL 中的组件不会自动全局可用。有两种常用方式启用：

• 在主项目的 _Imports.razor 中添加：@using MyComponentLib.Components（假设组件在该命名空间）
• 在具体页面或布局中局部使用：@using MyComponentLib.Components，然后直接写 <alert message="Hello"></alert>

注意：RCL 的程序集会被自动发布到输出目录（WebAssembly 的 _framework 或 Server 的 bin/.../refs），无需额外配置。

标签： css html js go svg app microsoft 作用域 .net 为什么 red