ASP.NET Core Razor Pages 从零搭建入门指南

我们可以把整个项目比喻成一家餐厅的运作体系。

---

第一步：先看项目结构（以默认模板为例）

当你通过 Visual Studio 或 dotnet new webapp 命令创建一个新项目后，会看到类似下面的文件夹和文件（不同版本可能略有差异，但核心一致）：

你的项目名称/ │
├── 📁 Properties/
│   └── launchSettings.json (配置文件：启动按钮的设置)
├── 📁 wwwroot/ (餐厅的"公共用餐区"：存放浏览器能直接访问的静态文件)
│   ├── 📁 css/ (样式文件 - 餐厅的装修风格)
│   ├── 📁 js/ (JavaScript 文件 - 服务员的现场互动)
│   └── 📁 lib/ (第三方库 - 比如借来的桌椅餐具)
├── 📁 Pages/ (餐厅的"核心包间区"：所有网页都在这里)
│   ├── 📁 Shared/ (公共组件：每个包间都有的墙壁、菜单样式)
│   │   └── _Layout.cshtml (网页的"骨架"：定义页眉、页脚、导航栏)
│   │   └── _ValidationScriptsPartial.cshtml (脚本片段：用于表单验证)
│   │
│   ├── Index.cshtml (首页：比如餐厅的入口大厅)
│   ├── Index.cshtml.cs (首页的"专属服务员"：处理首页的后台逻辑)
│   ├── Privacy.cshtml (隐私政策页)
│   └── Privacy.cshtml.cs (隐私页的专属服务员)
├── 📁 bin/ 和 📁 obj/ (厨房后厨：编译生成的临时文件和最终输出，一般不用管)
├── appsettings.json (餐厅的"规章制度手册"：数据库连接、应用配置)
├── appsettings.Development.json (开发环境专用的规章制度)
├── Program.cs (餐厅的"总设计师 + 总指挥"：应用的入口和启动配置)
└── 项目名称.csproj (餐厅的"购物清单"：项目依赖的包和 SDK)

---

第二步：详细讲解每个核心文件

1. Program.cs —— 餐厅的"总设计师 + 总指挥"

这是整个项目最先运行的地方，相当于你进入餐厅前，设计师画好蓝图、老板搭好骨架。

// 这是创建一个默认的 Web 应用构建器，相当于开始搭建餐厅
var builder = WebApplication.CreateBuilder(args);

// 告诉餐厅：我们使用 Razor Pages 模式营业
// 这会在系统中注册所有必要的服务，比如把"页面文件 (.cshtml)"和"服务员 (.cshtml.cs)"关联起来
builder.Services.AddRazorPages();

// 搭建完成，餐厅开始营业
var app = builder.Build();

// 配置 HTTP 请求管道：相当于设定客人进门后的路线
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler(); 
    app.UseHsts(); 
}

app.UseHttpsRedirection(); 
app.UseStaticFiles(); 
app.UseRouting(); 
app.MapRazorPages(); 

app.Run();