C# Blazor 开发环境搭建指南

要开始C# Blazor开发，需安装.NET SDK（如.NET 8）、选择Visual Studio或VS Code并配置相应扩展，再用dotnet new命令创建Blazor项目，运行dotnet watch run即可启动带热重载的开发服务器。

要开始 C# Blazor 开发，核心是装好 .NET SDK、选对 IDE（推荐 Visual Studio 或 VS Code），再创建一个 Blazor 项目即可。不需要额外配置运行时或复杂工具链，.NET 6+ 已内置完整支持。

安装 .NET SDK（必须）

Blazor 是 .NET 的一部分，不是独立框架，所以第一步一定是装对版本的 .NET SDK：

• 访问 https://www./link/c9f8941c38b7d49a586adf043f2acf21，下载最新长期支持版（LTS），如 .NET 8 或 .NET 6（仍受支持）；
• Windows 用户建议勾选“包含 Visual Studio 支持”选项（即使不用 VS，它会自动装好运行时和开发工具）；
• 安装完成后，在终端运行 dotnet --version 确认输出类似 8.0.100 的版本号；
• Blazor Server 和 Blazor WebAssembly 都由同一个 SDK 支持，无需分开安装。

选择并配置开发工具

Visual Studio 和 VS Code 都能高效开发 Blazor，区别在于开箱体验和轻量需求：

• Visual Studio（Windows/macOS）：安装时勾选“.NET 桌面开发”和“ASP.NET 和 Web 开发”工作负载，自带 Blazor 项目模板、调试器和 IIS Express 支持；
• VS Code（全平台）：需安装 C# 扩展（由 OmniSharp 提供）、.NET Install Tool for Extension Authors（可选但推荐），再通过终端用 dotnet new blazorserver 或 dotnet new blazorwasm 创建项目；
• 无论用哪个编辑器，都建议启用 dotnet watch run 实现热重载（保存即刷新页面），这是 Blazor 开发提效的关键。

创建并运行第一个 Blazor 项目

命令行是最通用的方式，几秒就能跑起来：

• 打开终端，执行：
  dotnet new blazorserver -n MyFirstBlazorApp
  或 WebAssembly 版：
  dotnet new blazorwasm -n MyFirstBlazorApp
• 进入项目目录：cd MyFirstBlazorApp
• 启动开发服务器：dotnet watch run
• 浏览器自动打开 https://localhost:5001（HTTPS）或 http://localhost:5000（HTTP），看到默认首页即成功。

验证调试与常见问题

运行起来不等于调试就通了，几个关键点要确认：

• 在 Program.cs 中确保启用了热重载（.NET 6+ 默认开启）；
• VS Code 调试需在项目根目录添加 .vscode/launch.json，使用 coreclr 类型配置；
• 如果遇到 ERR_CONNECTION_REFUSED，检查端口是否被占用，或尝试 dotnet run --urls http://localhost:5005 换端口；
• WebAssembly 项目首次运行较慢（需下载 .NET 运行时 wasm 文件），后续刷新会快很多。

基本上就这些。不需要 Node.js、npm 或 webpack，Blazor 的现代开发流已经高度集成进 .NET 生态。只要 SDK 装对、命令敲准、浏览器能连上，你就已经在写 C# 前端了。