新手推荐从 Blazor Server 入手，用 .NET CLI 执行 dotnet new blazorserver -n MyFirstBlazor 创建项目并 dotnet run 启动，默认访问 https://www.php.cn/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.php.cn/link/8b49217b4e704d2c40e5908ebd53eda5
浏览器打开后就能看到默认首页，带导航菜单和交互式计数器——这就是你第一个可运行的 Blazor 页面。
用 Visual Studio 图形化创建（Windows/macOS）
打开 Visual Studio（2022 17.4+），选择「创建新项目」→ 搜索 “Blazor Server App” → 点击创建 → 填写项目名、位置、框架（如 .NET 8.0）→ 完成。
将一个或多个 UI 原型图、线框图、产品截图或设计稿转换为标准化、可直接交付的 PRD 风格文档，供产品、设计、前端和测试共同使用。适用于 Codex 需要分析 PC 网页、桌面端、移动端、响应式页面、独立弹窗、表单、表格、看板、数据大屏或多页面流程截图，还原页面结构与交互，强制套用固定文档模板，抽取跨页面共享规则，或把一组原型沉淀为单页规范文档加整体业务流程文档的场景。不适用于纯视觉审美点评、代码实现、接口设计、埋点方案、竞品分析或无 UI 输入的业务需求创作。
- 解决方案资源管理器里重点看 Pages/Counter.razor：这是带按钮和状态更新的组件，双击就能编辑
- 按 F5 直接启动调试，修改代码后保存，浏览器会自动刷新（启用热重载）
关键文件和运行逻辑说明
Blazor Server 不是纯前端框架，它通过 SignalR 实时连接服务器，UI 更新在服务端渲染，再推送到浏览器。所以你不需要配 Webpack 或 npm 构建流程。
- Program.cs 是入口，注册了服务并配置了路由中间件
-
App.razor 是根组件，定义了路由规则（
<router></router>）和布局（<headoutlet></headoutlet>、<found></found>） -
_Imports.razor 自动导入常用命名空间，避免每个 .razor 文件重复写
@using
下一步可以试试的小改动
验证是否真正上手，动手改两处：
- 打开 Pages/Counter.razor，把
currentCount++改成currentCount += 2，保存后点“Click me”，数字每次加 2 - 在 Shared/NavMenu.razor 中新增一个菜单项：
<navlink class="nav-link" href="hello">Hello</navlink>，再新建 Pages/Hello.razor，写上<h3>Hello from Blazor!</h3>
基本上就这些。不复杂但容易忽略的是：Blazor Server 默认启用 HTTPS 开发证书，首次运行可能弹出信任提示，按向导操作一次即可。
