在Linux系统上借助Visual Studio开展ASP.NET开发，需要完成系统环境适配、工具链安装、项目配置等一系列操作，才能让开发流程顺畅运行。不同Linux发行版的配置细节略有差异，但核心步骤基本一致。
系统环境准备
首先确保Linux系统版本符合开发要求，推荐使用Ubuntu 20.04及以上版本、Fedora 34及以上版本或者Debian 11及以上版本。同时需要保证系统已经安装好基础的开发工具，比如gcc、make等编译工具，避免后续安装依赖时出现报错。
如果你的系统是Ubuntu，可以通过以下命令安装基础工具：
# 更新软件源 sudo apt update # 安装基础编译工具 sudo apt install -y build-essential
安装.NET SDK
ASP.NET开发依赖.NET SDK，需要安装对应版本的SDK。建议安装.NET 6及以上版本，兼容性更好。可以通过微软官方提供的包管理器源来安装，避免版本不匹配的问题。
Ubuntu系统安装步骤
首先添加微软的包签名密钥和软件源：
# 添加微软包签名密钥 wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb sudo dpkg -i packages-microsoft-prod.deb rm packages-microsoft-prod.deb # 更新软件源 sudo apt update
之后安装.NET SDK：
# 安装.NET 8 SDK，可根据需要替换版本号 sudo apt install -y dotnet-sdk-8.0
验证SDK安装
安装完成后执行以下命令验证是否安装成功：
dotnet --version
如果输出对应的版本号，说明SDK安装成功。
安装Visual Studio
Linux上目前可以使用Visual Studio Code或者Visual Studio的跨平台版本，这里推荐使用Visual Studio Code，轻量且适配性好。可以通过系统包管理器或者官网下载安装包进行安装。
以Ubuntu为例，通过snap安装Visual Studio Code：
sudo snap install code --classic
配置Visual Studio开发环境
安装完成Visual Studio Code后，需要安装对应的扩展来支持ASP.NET开发。
安装必要扩展
打开Visual Studio Code，在扩展面板搜索并安装以下扩展：
- C#：提供C#语言支持，包括语法高亮、智能提示、调试功能
- NuGet Package Manager：用于管理ASP.NET项目的NuGet依赖包
- ASP.NET Core Snippets：提供常用的ASP.NET代码片段，提升编码效率
配置调试环境
创建或者打开一个ASP.NET项目后，需要配置调试启动文件。在项目根目录下创建.vscode文件夹，然后创建launch.json文件，内容如下：
{
"version": "0.2.0",
"configurations": [
{
"name": ".NET Core Launch (web)",
"type": "coreclr",
"request": "launch",
"preLaunchTask": "build",
"program": "${workspaceFolder}/bin/Debug/net8.0/你的项目名称.dll",
"args": [],
"cwd": "${workspaceFolder}",
"stopAtEntry": false,
"serverReadyAction": {
"action": "openExternally",
"pattern": "\bNow listening on:\s+(https?://\S+)"
},
"env": {
"ASPNETCORE_ENVIRONMENT": "Development"
},
"sourceFileMap": {
"/Views": "${workspaceFolder}/Views"
}
}
]
}
注意将上面的你的项目名称替换成实际的项目名称，net8.0替换成项目实际使用的.NET版本。
创建并运行测试项目
完成上述配置后，可以创建一个简单的ASP.NET项目验证环境是否正常。
执行以下命令创建ASP.NET Web API项目：
# 创建项目目录 mkdir aspnet_test cd aspnet_test # 创建ASP.NET Web API项目 dotnet new webapi
用Visual Studio Code打开该项目，按下F5启动调试，如果浏览器自动打开并显示API的默认返回信息，说明整个配置流程成功完成。
常见问题排查
如果启动项目时出现端口占用的问题，可以修改项目的Properties/launchSettings.json文件中的端口配置，更换成未被占用的端口。如果出现依赖包安装失败的问题，可以检查网络连接，或者更换NuGet镜像源，将镜像源地址替换成ipipp.com对应的NuGet镜像地址即可。
ASP.NETVisual_StudioLinuxdotnet_sdk修改时间：2026-06-16 11:18:32