.NET Core Web API 开发入门:环境搭建与项目初始化实战

作者:xiaoxin.gao · 2025-06-27 · 阅读时间:4分钟
引言:迈入 .NET Core Web API 世界 欢迎来到 .NET Core Web API 入门课程! […]

引言:迈入 .NET Core Web API 世界

欢迎来到 .NET Core Web API 入门课程!本系列将从基础环境安装开始,最终手把手带你构建具备用户认证、数据持久化、前后端分离的股票社交平台 API。本节先完成 开发工具与项目模板 准备,后续章节再逐步深入功能实现。


一、安装 Visual Studio Code

  1. 打开浏览器,搜索 “Visual Studio Code”,进入官网后点击 “Download for Windows”。
  2. 安装过程“一键式”,界面简洁,适合插件扩展和轻量级开发。

二、安装 Visual Studio Community(包含 .NET 运行时)

  1. 搜索 “Visual Studio” 并下载 Community 版本(永久免费),该安装包自带 .NET SDK 和运行时。
  2. 安装时仅勾选 “.NET 桌面开发”“ASP.NET 和 Web 开发” 工作负载,无需安装额外 Node.js、Python。

三、安装 SQL Server Express 与 SSMS

  1. 在 Microsoft 官网下载 SQL Server Express,选择“Basic”一键安装。
  2. 完成后访问 SQL Server Management Studio (SSMS) 官方页面,安装并打开,用于日后创建和管理数据库。

四、创建 Web API 项目模板

  1. 在 VS Code 中,新建空文件夹(如 FinShark),打开集成终端。
  2. 执行以下命令,生成 Web API 模板并命名子文件夹 API

    dotnet new webapi -o API
  3. 进入 API 目录 (cd API),即完成项目初始结构搭建。

五、启动项目并初探 Swagger UI

  1. 确保当前目录在 API 文件夹,执行:

    dotnet watch run
  2. 启动后自动打开 Swagger UI,展示默认的 CRUD 接口,方便后续测试和文档查看。

六、清理 Program.cs 中的样板代码

  1. 打开 Program.cs,删除默认的最小 API 示例及生成的 WeatherForecast 记录类型。
  2. 保留 var builder = WebApplication.CreateBuilder(args);var app = builder.Build();,并在两者间配置依赖注入与中间件;最后调用 app.Run()

七、理解 API 基础(CRUD 与 HTTP 动词)

  • CreatePOST
  • ReadGET
  • UpdatePUT/PATCH
  • DeleteDELETE

掌握这些 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