要开始 C# Blazor 开发,核心是装好 .NET SDK、选对 IDE(推荐 Visual Studio 或 VS Code),再创建一个 Blazor 项目即可。不需要额外配置运行时或复杂工具链,.NET 6+ 已内置完整支持。
安装 .NET SDK(必须)
Blazor 是 .NET 的一部分,不是独立框架,所以第一步一定是装对版本的 .NET SDK:
访问 https://www.php.cn/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# 前端了。
