新手推荐从 Blazor Server 入手,用 .NET CLI 执行 dotnet new blazorserver -n MyFirstBlazor 创建项目并 dotnet run 启动,默认访问 https://www./link/8b49217b4e704d2c40e5908ebd53eda5;Visual Studio 中选择“Blazor Server App”模板创建,F5 调试支持热重载,核心文件包括 Program.cs、App.razor 和 Pages/Counter.razor。
用 Visual Studio 或 .NET CLI 创建 Blazor 应用非常简单,关键是选对模板和运行方式。Blazor 分为 Blazor Server 和 Blazor WebAssembly 两种托管模型,新手推荐从 Blazor Server 入手——它无需浏览器下载大量 .NET 运行时,启动快、调试顺、依赖少。
用 .NET CLI 快速创建 Blazor Server 应用
确保已安装 .NET SDK(建议 8.0 或 9.0)。打开终端,执行:
- dotnet new blazorserver -n MyFirstBlazor —— 创建名为 MyFirstBlazor 的服务端 Blazor 项目
- cd MyFirstBlazor
- dotnet run —— 启动应用,默认访问 https://www./link/8b49217b4e704d2c40e5908ebd53eda5
浏览器打开后就能看到默认首页,带导航菜单和交互式计数器——这就是你第一个可运行的 Blazor 页面。
用 Visual Studio 图形化创建(Windows/macOS)
打开 Visual Studio(2025 17.4+),选择「创建新项目」→ 搜索 “Blazor Server App” → 点击创建 → 填写项目名、位置、框架(如 .NET 8.0)→ 完成。
- 解决方案资源管理器里重点看 Pages/Counter.razor:这是带按钮和状态更新的组
件,双击就能编辑 - 按 F5 直接启动调试,修改代码后保存,浏览器会自动刷新(启用热重载)
关键文件和运行逻辑说明
Blazor Server 不是纯前端框架,它通过 SignalR 实时连接服务器,UI 更新在服务端渲染,再推送到浏览器。所以你不需要配 Webpack 或 npm 构建流程。
- Program.cs 是入口,注册了服务并配置了路由中间件
-
App.razor 是根组件,定义了路由规则(
)和布局(、) -
_Imports.razor 自动导入常用命名空间,避免每个 .razor 文件重复写
@using
下一步可以试试的小改动
验证是否真正上手,动手改两处:
- 打开 Pages/Counter.razor,把
currentCount++改成currentCount += 2,保存后点“Click me”,数字每次加 2 - 在 Shared/NavMenu.razor 中新增一个菜单项:
,再新建 Pages/Hello.razor,写上Hello Hello from Blazor!
基本上就这些。不复杂但容易忽略的是:Blazor Server 默认启用 HTTPS 开发证书,首次运行可能弹出信任提示,按向导操作一次即可。

件,双击就能编辑






