C# Blazor 开发环境搭建指南

来源:这里教程网 时间:2026-02-21 17:35:53 作者:

要开始 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# 前端了。

相关推荐