什么是 REST API？
.NET Core Web API 开发入门：环境搭建与项目初始化实战
关键词:
.NET Core Web API 入门
dotnet new webapi 项目模板
dotnet watch run 实时重启
Swagger UI 快速测试
VS Code .NET API 环境搭建
Windows 上安装 SQL Server Express 与 SSMS
作者: xiaoxin.gao
2025-06-27
引言：迈入 .NET Core Web API 世界
欢迎来到 .NET Core Web API 入门课程！本系列将从基础环境安装开始，最终手把手带你构建具备用户认证、数据持久化、前后端分离的股票社交平台 API。本节先完成 开发工具与项目模板 准备，后续章节再逐步深入功能实现。
一、安装 Visual Studio Code
- 打开浏览器，搜索 “Visual Studio Code”，进入官网后点击 “Download for Windows”。
- 安装过程“一键式”，界面简洁，适合插件扩展和轻量级开发。
二、安装 Visual Studio Community（包含 .NET 运行时）
- 搜索 “Visual Studio” 并下载 Community 版本（永久免费），该安装包自带 .NET SDK 和运行时。
- 安装时仅勾选 “.NET 桌面开发” 与 “ASP.NET 和 Web 开发” 工作负载，无需安装额外 Node.js、Python。
三、安装 SQL Server Express 与 SSMS
- 在 Microsoft 官网下载 SQL Server Express，选择“Basic”一键安装。
- 完成后访问 SQL Server Management Studio (SSMS) 官方页面，安装并打开，用于日后创建和管理数据库。
四、创建 Web API 项目模板
- 在 VS Code 中，新建空文件夹（如
FinShark），打开集成终端。 -
执行以下命令，生成 Web API 模板并命名子文件夹
API：dotnet new webapi -o API - 进入
API目录 (cd API)，即完成项目初始结构搭建。
五、启动项目并初探 Swagger UI
-
确保当前目录在
API文件夹，执行：dotnet watch run - 启动后自动打开 Swagger UI，展示默认的 CRUD 接口，方便后续测试和文档查看。
六、清理 Program.cs 中的样板代码
- 打开
Program.cs，删除默认的最小 API 示例及生成的WeatherForecast记录类型。 - 保留
var builder = WebApplication.CreateBuilder(args);与var app = builder.Build();，并在两者间配置依赖注入与中间件；最后调用app.Run()。
七、理解 API 基础（CRUD 与 HTTP 动词）
- Create → POST
- Read → GET
- Update → PUT/PATCH
- Delete → DELETE
掌握这些 HTTP 方法与数据库操作（CRUD）之间的映射，是设计符合 REST 标准的 Web API 的关键。
小结与下一步
本节目标已完成：
- 安装 VS Code、Visual Studio、SQL Server & SSMS；
- 创建并运行
.NET Core Web API项目； - 清理样板代码并了解 CRUD 对应的 HTTP 动词。
下一章，我们将配置 Entity Framework Core 并实现首个实体的 CRUD 操作。敬请期待！
原文引自YouTube视频：https://www.youtube.com/watch?v=qBTe6uHJS_Y
🔥