Blazor 怎么创建第一个应用

新手推荐从 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 ServerBlazor 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 中新增一个菜单项:Hello,再新建 Pages/Hello.razor,写上

    Hello from Blazor!

基本上就这些。不复杂但容易忽略的是:Blazor Server 默认启用 HTTPS 开发证书,首次运行可能弹出信任提示,按向导操作一次即可。