第一步：准备工作 - 安装开发环境
在开始之前，你需要安装必要的软件，对于现代 ASP.NET 开发，.NET 6 或更高版本是首选,因为它支持更简洁的模型。
（图片来源网络，侵删）
安装 .NET SDK (Software Development Kit)
SDK 包含了运行和开发 .NET 应用所需的一切，包括运行时、编译器和命令行工具。
- 下载地址: https://dotnet.microsoft.com/download
- 建议版本: 下载最新的 LTS (长期支持) 版本，.NET 8.0,它会为你提供最稳定和广泛的支持。
- 安装: 按照向导完成安装，安装后，打开命令行工具（如 PowerShell 或 CMD），输入
dotnet --version，如果能显示版本号,说明安装成功。
安装代码编辑器
你需要一个编辑器来编写代码，强烈推荐 Visual Studio Code，它免费、轻量且功能强大。
- 下载地址: https://code.visualstudio.com/
- 安装: 按照向导完成安装。
- 安装必备扩展: 打开 VS Code，进入扩展市场 (Extensions)，搜索并安装以下两个扩展：
- C# Dev Kit: 提供顶级的 C# 开发体验。
- IntelliCode for C# Dev Kit: 提供智能代码补全。
第二步：创建你的第一个 ASP.NET 网站
我们将创建一个最简单的 ASP.NET Core Web API 项目，这是目前最主流和推荐的方式，因为它可以同时服务于 Web 页面和移动 App。
使用命令行创建项目
打开你的终端（Windows 的 PowerShell 或 CMD，或者 macOS/Linux 的 Terminal）,然后执行以下命令：
（图片来源网络，侵删）
# 创建一个名为 "MyFirstWebApp" 的新文件夹，并进入该文件夹 mkdir MyFirstWebApp cd MyFirstWebApp # 使用模板创建一个新的 Web API 项目 dotnet new webapi -o MyFirstWebApp
dotnet new webapi: 告诉 .NET CLI 使用 "webapi" 模板来创建项目。-o MyFirstWebApp: 指定输出目录的名称，这会创建一个名为MyFirstWebApp的子文件夹,并将所有文件放在里面。
执行后,你会看到项目文件被创建。
使用 Visual Studio Code 打开项目
在终端中，确保你还在 MyFirstWebApp 文件夹下,然后运行：
code .
这会用 VS Code 打开当前文件夹，你会看到一个类似文件管理器的界面,包含了你的项目文件。
运行和测试项目
让我们启动这个网站。
（图片来源网络，侵删）
-
在 VS Code 中，按
F5或者点击右上角的 "Run and Debug" 按钮（看起来像一个绿色的播放按钮）。 -
VS Code 会提示你选择一个环境，选择 .NET 5+ and .NET Core。
-
项目会自动编译并启动，你会看到一个终端窗口，显示类似下面的信息,并告诉你应用正在运行：
info: Microsoft.Hosting.Lifetime[14] Now listening on: https://localhost:7123 info: Microsoft.Hosting.Lifetime[14] Now listening on: http://localhost:5123 info: Microsoft.Hosting.Lifetime[0] Application started. Press Ctrl+C to shut down. -
测试网站:
- 打开你的浏览器。
- 在地址栏输入上面显示的 HTTPS 地址，
https://localhost:7123 - 你会看到一个页面，显示 "Cannot GET /"，这是因为我们创建的是 API 项目,默认没有提供网页路由。
- 输入 API 的默认路由：
https://localhost:7123/weatherforecast - 你会看到一个 JSON 格式的响应,内容类似这样：
[ { "date": "2025-10-27T10:30:02.1234567+08:00", "temperatureC": 20, "temperatureF": 68, "summary": "Brisk" }, // ... 更多预报数据 ]
恭喜！你已经成功创建并运行了你的第一个 ASP.NET 网站！
第三步：了解项目结构和关键文件
让我们看看 VS Code 左侧的文件浏览器,了解这些文件的作用。
MyFirstWebApp/
├── MyFirstWebApp.csproj // 项目配置文件，定义了项目依赖和设置
├── appsettings.json // 应用的配置文件，如数据库连接字符串、日志级别等
├── Program.cs // **应用程序的入口点**，定义了请求如何被处理
├── Properties/
│ └── launchSettings.json // 调试和启动的配置，比如端口号
└── Controllers/
└── WeatherForecast.cs // **控制器**，处理具体的 HTTP 请求并返回响应Program.cs - 请求管道
这是整个应用的心脏，它定义了当请求到达时，应该经过哪些“中间件”（Middleware）进行处理。
var builder = WebApplication.CreateBuilder(args);
// 1. 添加服务到容器 (DI - 依赖注入)
builder.Services.AddControllers();
// 2. 配置 Swagger/OpenAPI (API 文档)
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
var app = builder.Build();
// 3. 配置请求处理管道
if (app.Environment.IsDevelopment())
{
app.UseSwagger();
app.UseSwaggerUI();
}
app.UseHttpsRedirection(); // 强制使用 HTTPS
app.UseAuthorization(); // 授权中间件
app.MapControllers(); // 将路由映射到控制器
app.Run();
代码做了三件事：
- 配置: 注册服务（如控制器、Swagger）。
- 构建: 创建一个应用对象。
- 运行: 定义请求的“流水线”，比如先检查是不是开发环境，然后重定向到 HTTPS,最后交给控制器处理。
Controllers/WeatherForecast.cs - 控制器
控制器是处理 HTTP 请求并返回响应的类，它遵循 RESTful 风格。
[ApiController]
[Route("[controller]")] // 定义路由模板，如 /weatherforecast
public class WeatherForecastController : ControllerBase
{
private static readonly string[] Summaries = new[]
{
"Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching"
};
[HttpGet] // 定义一个 GET 请求处理方法
public IEnumerable<WeatherForecast> Get()
{
// ... 生成并返回天气预报数据的逻辑
}
}
[ApiController]: 一个属性，标记这个类是 API 控制器，提供一些默认行为（如自动验证模型）。[Route("[controller]")]: 定义这个控制器的基路由。[controller]是一个占位符，会自动使用控制器的名字（去掉 "Controller" 后缀），所以这里就是/weatherforecast。[HttpGet]: 标记这个方法只处理 HTTP GET 请求，访问/weatherforecast时,这个方法就会被执行。
第四步：下一步可以做什么？
你已经掌握了基础,现在可以开始构建更复杂的应用了。
-
创建一个简单的网页 (MVC):
- 除了 API，ASP.NET 还有一个经典的 MVC (Model-View-Controller) 模式,用于构建网页。
- 在
Program.cs中，将builder.Services.AddControllers();替换为builder.Services.AddRazorPages();。 - 在项目根目录创建一个
Pages文件夹，然后添加一个Index.cshtml文件，在里面写一些 HTML。 - 运行项目后访问
/Index就能看到你的网页了。
-
连接数据库:
- 学习使用 Entity Framework Core (EF Core)，这是微软官方的 ORM（对象关系映射）工具。
- 你可以通过 NuGet 包管理器添加
Microsoft.EntityFrameworkCore.SqlServer或Microsoft.EntityFrameworkCore.Sqlite。 - 创建一个 "Model" 类来表示你的数据表，然后创建一个 "DbContext" 类来管理数据库连接和操作。
-
用户认证和授权:
- 使用 ASP.NET Core Identity 或更现代的 IdentityServer4/5 来实现用户登录、注册和权限管理。
-
前端集成:
- 学习如何使用像 Razor Class Libraries 这样的技术，在同一个项目中结合后端 API 和前端 UI（如使用 Blazor、React 或 Angular）。
创建 ASP.NET 网站的流程可以概括为：
- 安装环境: .NET SDK 和 VS Code。
- 创建项目: 使用
dotnet new webapi命令。 - 理解结构:
Program.cs是入口，Controllers处理请求。 - 运行测试: 使用
F5启动，并在浏览器中访问 API 端点。 - 持续学习: 探索 MVC、数据库、认证等高级特性。
ASP.NET 生态系统非常强大，社区支持也很好，希望这个指南能帮助你顺利开启 Web 开发之旅！如果你有任何具体问题,随时可以提问。
