配置 ASP.NET 开发环境主要分为两种场景:传统 ASP.NET(基于 .NET Framework)和跨平台 ASP.NET Core(基于 .NET 5/6/7/8),以下是详细步骤:

ASP.NET Core 环境配置(推荐)
安装 .NET SDK
- 下载地址:.NET 官方下载页
- 选择最新 LTS 版本(如 .NET 8)的 SDK 安装包(Windows/macOS/Linux 通用)。
- 安装后验证:
dotnet --version # 输出版本号(如 8.0.100)即成功
安装 IDE(可选但推荐)
- Visual Studio (Windows/macOS):
- 社区版免费:下载 Visual Studio
- 安装时勾选 ASP.NET 和 Web 开发 工作负载。
- Visual Studio Code(跨平台):
- 下载地址:VS Code
- 安装扩展:
C#(由 Microsoft 发布)ASP.NET Core Switcher(辅助工具)
创建并运行项目
# 创建 ASP.NET Core Web 应用 dotnet new webapp -n MyFirstApp cd MyFirstApp # 运行项目 dotnet run
- 访问
https://localhost:5001或http://localhost:5000。
传统 ASP.NET (基于 .NET Framework) 环境配置
仅适用于 Windows
启用 IIS(Web 服务器)
- 打开 控制面板 > 程序 > 启用或关闭 Windows 功能。
- 勾选:
- Internet Information Services (展开后勾选所有子项)
- .NET Framework 4.x 高级服务 → ASP.NET 4.x
安装 Visual Studio
- 下载 Visual Studio,安装时勾选:
- ASP.NET 和 Web 开发
- .NET 桌面开发(可选)
- SQL Server Express(数据库支持)
创建并运行项目
- 打开 Visual Studio → 新建项目 → ASP.NET Web 应用程序 (.NET Framework)。
- 选择模板(如 MVC、Web Forms)→ 点击运行(F5)。
- 项目将自动部署到 IIS Express。
数据库配置(可选)
SQL Server
- 安装 SQL Server Express(免费)。
- 或使用 LocalDB(已随 Visual Studio 安装):
sqllocaldb info # 查看 LocalDB 实例
SQLite / PostgreSQL / MySQL
- ASP.NET Core 支持多种数据库:
dotnet add package Microsoft.EntityFrameworkCore.Sqlite # SQLite dotnet add package Npgsql.EntityFrameworkCore.PostgreSQL # PostgreSQL
验证环境
ASP.NET Core
# 全局安装模板(可选) dotnet new -i Microsoft.AspNetCore.WebApi # 创建 Web API 项目 dotnet new webapi -n ApiDemo cd ApiDemo dotnet run # 访问 https://localhost:5001/weatherforecast
传统 ASP.NET
- 在 Visual Studio 中创建 ASP.NET MVC 项目,按 F5 运行。
常见问题解决
dotnet命令未找到:- 重启终端或检查环境变量
PATH是否包含C:Program Filesdotnet。
- 重启终端或检查环境变量
- 端口冲突:
- 修改
Properties/launchSettings.json(ASP.NET Core)或项目属性中的调试端口。
- 修改
- IIS 无法启动:
- 以管理员身份运行 Visual Studio。
- 重置 IIS:
iisreset(命令提示符)。
| 组件 | ASP.NET Core 跨平台方案 | 传统 ASP.NET (Windows) |
|---|---|---|
| 运行时 | .NET 6/7/8 SDK | .NET Framework 4.8 |
| 服务器 | Kestrel(内置) | IIS / IIS Express |
| 开发工具 | VS Code / VS / Rider | Visual Studio |
| 部署平台 | Windows/Linux/macOS/Docker | Windows Server |
推荐使用 ASP.NET Core,微软已停止更新传统 ASP.NET 的新功能。
图片来源于AI模型,如侵权请联系管理员。作者:酷小编,如若转载,请注明出处:https://www.kufanyun.com/ask/287792.html

