用途:通过 dotnet new blazor 模板创建新的 ASP.NET Core Blazor Web 应用或网站,并在脚手架前先明确应用功能、交互需求、部署环境与认证要求。
主要能力:按渲染模式生成项目,包括静态 SSR(-int None)、交互式 Server(-int Server,可加 -ai 全局)、交互式 WebAssembly(-int WebAssembly)、交互式 Auto(-int Auto)。支持追加 -au Individual 生成 ASP.NET Core Identity 认证。模板会生成 Components、Program.cs、wwwroot 等结构;WebAssembly 与 Auto 会额外生成 .Client 项目。
使用方式:例如 dotnet new blazor -o {AppName} -int Server;全局交互加 -ai;认证加 -au Individual。脚手架后建议创建 AGENTS.md,并运行 dotnet build 与 dotnet run 验证。
适用场景:需要快速搭建 Blazor 应用骨架、选择合适交互级别、配置服务注册与渲染模式时。
限制:Auto 模式要求交互组件位于 .Client 项目、数据访问走 HTTP API、两端服务注册匹配;WebAssembly 首次访问需下载运行时;Identity 页面始终为静态 SSR,不能加 @rendermode;不要使用 dotnet new blazorwasm 替代。具体模板文件与更多细节以官方资料为准。