环境搭建：.NET SDK安装、创建SignalR项目、引入NuGet包、项目结构解析

好，咱们正式开始动手了。这一章我带你把开发环境搭起来。说实话，很多新手在环境搭建这一步就卡住了，不是SDK版本不对，就是NuGet包引用冲突。我当年刚接触SignalR时也踩过类似的坑，所以这一章我会把每个细节都讲透。

1. .NET SDK安装：选对版本很重要

首先，你得装.NET SDK。SignalR从ASP.NET Core 2.1开始就内置了，但我个人建议直接用最新的LTS版本。目前推荐.NET 8.0，稳定且性能好。

去官网下载安装包，一路Next就行。装完后打开终端验证一下：

dotnet --version
dotnet --list-sdks

如果能看到版本号，说明装好了。嗯，这里要注意：如果你电脑上同时装了多个版本，记得检查全局SDK版本。我遇到过有人装了.NET 6却用.NET 8的语法写代码，结果编译报错，排查了半天。

2. 创建SignalR项目：两种方式随你选

项目创建有两种方式，我分别说一下。

方式一：命令行创建（推荐）

打开终端，找个工作目录，敲下面这条命令：

dotnet new web -n SignalRChatDemo
cd SignalRChatDemo

这会生成一个最简的ASP.NET Core Web项目。为什么选空模板？因为SignalR不需要MVC那一套，轻装上阵。

方式二：Visual Studio创建

如果你习惯用IDE，那就新建项目，选「ASP.NET Core Web应用（空）」。框架选.NET 8.0，身份验证类型选「无」。我个人其实更爱用命令行，因为快，而且能清楚看到每一步发生了什么。

3. 引入NuGet包：SignalR其实不用额外装

你可能会问：要不要装Microsoft.AspNetCore.SignalR这个包？

答案是：不用。从ASP.NET Core 2.1开始，SignalR已经内置在框架里了。你只需要在项目中引用对应的命名空间就行。

但如果你要用一些高级功能，比如Azure SignalR Service或者Redis背板，那就得装额外的包了。咱们现在做基础开发，一个包都不用装。

验证一下：打开项目文件（.csproj），看看有没有SignalR相关的包引用。正常情况下应该是空的。如果你看到类似这样的内容：

<PackageReference Include="Microsoft.AspNetCore.SignalR" Version="8.0.0" />

那说明你画蛇添足了。删掉它，因为内置的版本更稳定，而且不会出现版本冲突。

4. 项目结构解析：每个文件是干嘛的

创建完项目后，你会看到这么几个文件。我带你逐个过一遍。

文件/文件夹	作用	我的建议
Program.cs	应用入口，配置服务和中间件	SignalR的注册和映射都在这里
appsettings.json	配置文件，存连接字符串等	开发阶段用默认值就行
Properties/launchSettings.json	启动配置，端口、环境变量等	可以改端口，避免冲突
wwwroot/	静态文件目录，放HTML、JS、CSS	SignalR客户端脚本放这里

咱们重点看Program.cs。打开它，默认内容是这样的：

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", () => "Hello World!");

app.Run();

这个结构很清晰：创建Builder、构建应用、配置路由、启动。SignalR要加的东西，就在Builder和路由配置之间插入。

你想想看，为什么SignalR能这么轻量？因为它本身就是ASP.NET Core的一部分，不需要额外的框架支持。这也是我偏爱它的原因之一。

5. 验证环境：跑起来看看

环境搭好了，咱们验证一下。在终端里运行：

dotnet run

看到类似这样的输出，说明成功了：

Now listening on: http://localhost:5000

打开浏览器访问这个地址，应该能看到「Hello World!」。虽然现在还没SignalR什么事，但至少证明你的开发环境是通的。

嗯，这里有个小细节：默认端口是5000，但如果你同时开了多个项目，可能会冲突。这时候可以去launchSettings.json里改端口，或者用--urls参数指定：

dotnet run --urls "http://localhost:5001"

6. 本章小结

好，环境搭建就到这里。咱们做了三件事：装了.NET SDK、建了空项目、理清了项目结构。下一章我会带你写第一个SignalR Hub，真正开始实时通信的编码。

最后提醒一句：如果你在搭建过程中遇到任何问题，先检查SDK版本，再检查项目文件。90%的环境问题都出在这两个地方。我曾经帮一个同事排查了整整一下午，最后发现他装的是.NET 5的SDK，却用.NET 8的模板创建项目……

行，动手试试吧。有问题随时翻回这一章看看。