Blazor 创建项目详细教程

来源:这里教程网 时间:2026-02-21 17:36:39 作者:

用 Visual Studio 或 .NET CLI 创建 Blazor 项目非常直接,关键是要选对模板和目标框架。下面分步骤讲清楚怎么创建一个可用的 Blazor 项目,包括服务端(Blazor Server)和 WebAssembly(Blazor WASM)两种主流类型。

确认开发环境已就绪

Blazor 是 .NET 生态的一部分,必须先装好对应版本的 .NET SDK(推荐 .NET 8 或 .NET 9,目前 LTS 版本是 .NET 8)。打开终端或命令行,运行:

dotnet --version

如果显示版本号(如 8.0.400),说明 SDK 已安装。Visual Studio 用户建议使用 VS 2022 17.8+,并勾选“ASP.NET 和 Web 开发”工作负载。

用 CLI 快速创建 Blazor Server 项目

这是最轻量、适合内网或快速原型的方案,所有逻辑在服务器执行,实时通过 SignalR 推送 UI 更新。

dotnet new blazorserver -n MyBlazorApp -f net8.0

-n MyBlazorApp:指定项目名和文件夹名 -f net8.0:明确指定目标框架(避免默认用最新预览版) 生成后进入目录:
cd MyBlazorApp
运行:
dotnet run
,浏览器打开
https://localhost:5001
即可看到首页

用 CLI 创建 Blazor WebAssembly(WASM)项目

适合部署到静态网站(如 GitHub Pages、Azure Static Web Apps),代码下载到浏览器中运行,支持 PWA 和离线能力。

dotnet new blazorwasm -n MyWasmApp -f net8.0 --hosted

--hosted:加上这个参数会生成“托管式”结构——包含一个 ASP.NET Core 后端 API 项目 + 一个独立的 WASM 前端项目,方便调用服务端接口 不加
--hosted
就是纯客户端项目(无后端,只能调外部 API 或本地存储)
运行整个托管方案:
dotnet run
(默认启动后端,前端自动由后端提供)

用 Visual Studio 图形界面创建(更直观)

打开 VS → “创建新项目” → 搜索 Blazor → 选择以下任一模板:

Blazor Server App:选“.NET 8.0”框架,认证方式按需选(如“无身份验证”) Blazor WebAssembly App:勾选“ASP.NET Core 托管”即等效 CLI 的
--hosted
点击“创建”,VS 自动还原 NuGet 包并生成完整解决方案 F5 运行即可,调试体验比 CLI 更友好(断点、热重载都支持)

基本上就这些。创建完项目后,

Pages/Counter.razor
Pages/FetchData.razor
是两个典型示例页面,可以马上改着试。注意区分
Program.cs
中的服务注册方式(Server 用
AddServerSideBlazor()
,WASM 用
AddBlazorWebAssemblyHostedService()
等),后续扩展功能时别混用。

相关推荐