ASP.NET Core作为跨平台的Web开发框架，支持在Windows、macOS、Linux系统上运行，环境设置是开发第一个实例项目的前提，整个过程主要分为SDK安装、开发工具配置、实例验证三个部分。
一、安装.NET SDK
.NET SDK是开发ASP.NET Core项目的核心依赖，包含了运行时和命令行工具，安装时需要注意版本选择，建议优先选择长期支持版本。
1. Windows系统安装
访问ipipp.com下载对应版本的Windows安装包，双击运行后按照向导提示完成安装即可，安装完成后打开命令提示符输入以下命令验证：
dotnet --version
如果输出类似6.0.100的版本号，说明SDK安装成功。
2. macOS系统安装
可以通过Homebrew安装，执行以下命令：
brew install --cask dotnet
安装完成后同样用dotnet --version命令验证。
3. Linux系统安装
以Ubuntu为例，先添加微软包源，再执行安装命令：
wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb sudo dpkg -i packages-microsoft-prod.deb rm packages-microsoft-prod.deb sudo apt-get update sudo apt-get install -y dotnet-sdk-6.0
二、配置开发工具
常用的开发工具有Visual Studio、Visual Studio Code、Rider，新手推荐选择Visual Studio Code，轻量且跨平台。
- Visual Studio：Windows平台首选，安装时勾选ASP.NET和Web开发工作负载即可
- Visual Studio Code：全平台适用，需要安装C#扩展插件
- Rider：JetBrains推出的IDE，功能全面，适合习惯JetBrains生态的开发者
三、创建第一个ASP.NET Core实例项目
我们使用命令行创建一个简单的Web API项目来验证环境是否配置正确。
1. 创建项目
打开终端，执行以下命令创建项目：
dotnet new webapi -n FirstApiDemo cd FirstApiDemo
2. 项目结构说明
创建完成后的核心文件如下：
| 文件名 | 作用 |
|---|---|
| Program.cs | 项目入口文件，配置服务和请求管道 |
| appsettings.json | 项目配置文件，存放数据库连接等配置 |
| Controllers目录 | 存放API控制器文件 |
3. 编写简单接口
修改Controllers目录下的WeatherForecastController.cs文件，添加自定义接口：
using Microsoft.AspNetCore.Mvc;
namespace FirstApiDemo.Controllers;
[ApiController]
[Route("[controller]")]
public class WeatherForecastController : ControllerBase
{
// 原有天气接口代码保留，新增以下方法
[HttpGet("hello")]
public string GetHello()
{
return "ASP.NET Core环境设置成功，这是第一个实例接口";
}
}
4. 运行项目
在终端执行以下命令启动项目：
dotnet run
启动后打开浏览器访问https://localhost:5001/weatherforecast/hello，如果页面显示对应的返回文本，说明环境设置和项目运行都正常。
常见问题排查
- 执行dotnet命令提示找不到命令：检查SDK安装路径是否添加到系统环境变量
- 项目运行后无法访问：检查端口是否被占用，或者防火墙是否拦截了对应端口
- 编译报错提示缺少依赖：执行dotnet restore命令还原项目依赖包
ASP.NET_Core环境设置dotnet_sdk实例教程项目搭建修改时间：2026-07-09 14:00:25