Asp.Net Core如何安装？详解Asp.Net Core安装的完整步骤

Asp.Net Core是微软推出的跨平台高性能框架，可用于构建现代云原生应用、Web应用和API服务，安装过程是开展相关开发工作的第一步。不同开发场景和需求对应的安装方式有所区别，开发者可以根据自身使用的操作系统和开发工具选择合适的方法。

安装前准备

在安装Asp.Net Core之前，需要先确认当前操作系统的版本是否满足要求。Windows系统需要Windows 7及以上版本，或者Windows Server 2012 R2及以上版本；macOS需要macOS 10.15及以上版本；Linux支持Ubuntu、Debian、CentOS、Fedora等主流发行版。同时建议预留至少2GB的磁盘空间用于存放SDK和相关依赖。

不同系统下安装Asp.Net Core SDK

Windows系统安装

Windows系统下最简便的安装方式是通过官网下载安装包，步骤如下：

• 打开浏览器访问微软官方dotnet下载页面，选择对应版本的Asp.Net Core SDK安装包，建议选择长期支持版本
• 下载完成后双击安装包，按照向导提示逐步完成安装，全程保持默认选项即可
• 安装完成后打开命令提示符，输入以下命令验证安装是否成功

dotnet --version

如果命令返回具体的版本号，说明SDK安装成功。

macOS系统安装

macOS系统可以通过安装包或者Homebrew工具完成安装：

• 安装包方式：下载对应版本的SDK安装包，双击pkg文件按照提示完成安装即可
• Homebrew方式：打开终端输入以下命令完成安装

brew install --cask dotnet-sdk

安装完成后同样可以通过dotnet --version命令验证安装结果。

Linux系统安装

以Ubuntu 22.04为例，安装步骤如下：

• 首先注册微软包存储库，输入以下命令

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

• 更新包索引并安装SDK

sudo apt-get update
sudo apt-get install -y dotnet-sdk-8.0

其他Linux发行版的安装命令可以在微软官方文档中查询对应版本的操作说明。

通过Visual Studio安装Asp.Net Core开发环境

如果使用Visual Studio作为开发工具，可以在安装Visual Studio时勾选相关 workload 完成Asp.Net Core环境的配置：

• 运行Visual Studio安装程序，选择修改已安装版本或者新建安装
• 在工作负载列表中勾选ASP.NET 和 Web 开发选项
• 在右侧的安装详情中，确保.NET SDK相关选项被勾选，点击修改或者安装按钮完成配置

安装完成后打开Visual Studio，创建新项目时可以看到Asp.Net Core相关的项目模板，说明环境配置成功。

命令行创建第一个Asp.Net Core项目

安装完成SDK后，可以通过命令行快速创建一个测试项目验证环境是否可用：

• 打开终端，进入想要存放项目的目录
• 输入以下命令创建Web API项目

dotnet new webapi -n MyFirstAspCoreApp

• 进入项目目录并运行项目

cd MyFirstAspCoreApp
dotnet run

项目运行后，终端会输出监听的地址，打开浏览器访问对应地址可以看到接口返回的结果，说明整个Asp.Net Core安装和配置流程全部完成。

常见安装问题排查

• 如果输入dotnet --version提示命令不存在，需要检查SDK的安装路径是否添加到系统环境变量中
• 如果创建项目时提示SDK版本不匹配，需要安装项目要求的对应版本的SDK
• Linux系统下安装时如果出现依赖缺失的错误，可以根据错误提示安装对应的系统依赖包

Asp.Net_Coredotnet_sdkVisual_Studio命令行安装项目创建修改时间：2026-07-20 01:27:14