第1章 观察哨就位：ASP.NET Core全景

第1章 观察哨就位：ASP.NET Core 全景

本章要回答的三个问题：一、ASP.NET 这二十年到底发生了什么，为什么今天的答案叫 ASP.NET Core？二、一个 HTTP 请求从浏览器发出到收到响应，中间大致经过哪几站？三、我该怎么把开发环境搭起来，并亲眼看到第一个请求的流动轨迹？

为什么会有这一章

很多教程第一章直接教"新建项目"，跳过了一个代价高昂的省略：不理解框架的来历和管线的存在，后面学每个特性都是悬空的。我曾接手一个遗留系统，团队里的同事把鉴权逻辑写在了控制器构造函数里，问原因，答"不知道有中间件这回事"。这不是个例。ASP.NET 家族二十多年积累了 Web Forms、MVC、Web API 多条技术线，如果不知道 .NET Core 在 2016 年推倒重来的历史动机，很容易在旧资料里打转——网上大量教程仍在讲 ViewState 和 System.Web，照着抄只会离现代开发越来越远。

本章把观察哨设在管线的最高处，先看全景：框架为什么重写、请求大致的旅程、开发环境怎么搭。细节站点的停靠留给后面各章。

读完能解决什么

对照开篇三个问题，读完本章你应当能：

• 用自己的话讲清 ASP.NET 与 ASP.NET Core 的分界线，以及 .NET Framework / .NET Core / 现代 .NET 三者的关系；
• 说出一个请求从 Kestrel 接收到响应写回的至少六个关键站点；
• 独立完成 .NET SDK 安装，创建第一个 Web 项目，并通过日志看到一次真实的请求处理记录。

各节怎么分工

第 1.1 节偏认知，篇幅不长但信息密度高，重点在"为什么重写"——跨平台、性能、开源、模块化这四个动机直接决定了后面七章里的每一个设计。第 1.2 节偏动手，从安装 SDK 到跑起项目，再到打开日志级别看清一次请求，为第 2 章拆解主机和中间件备好实验环境。

本章两节在管线全景中的位置

本章知识点清单

逐条对照，能独立复述并动手验证的才算掌握：

• 能说出 ASP.NET、ASP.NET Core、.NET Framework、.NET（5 及以后）四个名词的边界与包含关系；
• 能解释 2016 年重写的四个动机：跨平台、性能、开源、模块化，并各举一个框架设计上的对应物（如 Kestrel 对应跨平台、NuGet 化对应模块化）；
• 见到一段陌生代码，能按"年代鉴定三铁律"判断它属于哪一代技术；
• 能列出请求旅程的六个站点：浏览器、Kestrel、中间件管线、端点路由、业务代码、响应回流；
• 能独立完成 SDK 安装验证、项目创建、观察哨中间件添加、热重载运行这四个操作；
• 能解读控制台里"Now listening on"与请求日志两块输出分别说明了什么。

常见卡点与排错线索

• dotnet 命令不存在：SDK 没进系统路径，重开终端或检查安装；
• 端口被占用导致启动失败：换端口或找到占用进程，终端错误信息里会写明；
• 访问 404 但哨站有日志：说明管线通、端点没登记对，回查 MapGet 的模板拼写。

先决条件

• 一台能装 .NET 8 SDK 的开发机（Windows、macOS、Linux 均可）；
• 看得懂 C# 的类、方法与 lambda 表达式；
• 会用命令行执行简单命令——本章刻意用命令行创建项目，因为图形界面隐藏了太多值得观察的东西。

往下走到哪

本章结束时，你的观察哨能看到的只是请求流动的轮廓。第 2 章会把管线拆开：主机如何启动、中间件如何按顺序注册、配置和日志从哪里来。1.2 节里看到的 WebApplication 一行式启动，会在第 2 章被还原成它内部真实的样子。