Visual Studio零基础从零开始创建空ASP.NET Core Web项目完整学习教程

在 Visual Studio 中创建空的 ASP.NET Core Web 项目：从零开始的全流程指南

Visual Studio 作为一款功能强大的集成开发环境（IDE），能够高效帮助开发者创建各类项目。对于刚接触 ASP.NET Core 的开发者而言，从“空”项目起步，可以完全掌控项目结构与配置，避免被模板代码干扰学习。本文将详细讲解如何在 Visual Studio 中创建空的 ASP.NET Core Web 项目，逐步添加所需功能，并提供实用技巧与常见问题解答。

准备工作

开始前，请确保计算机已安装 Visual Studio，并已安装 ASP.NET 和 Web 开发 工作负载。可通过以下步骤检查与安装：

• 打开 Visual Studio 安装程序。
• 在已安装版本旁，点击“修改”。
• 在“工作负载”选项卡中，勾选“ASP.NET 和 Web 开发”。
• 点击“修改”按钮，等待安装完成。

小提示： 若已安装该工作负载但不确定完整性，可重新运行安装程序，勾选后确认状态显示为“已安装”。

创建项目

1. 打开 Visual Studio，在启动窗口中选择“创建新项目”。
2. 在搜索框中输入 asp.net core web 应用，从结果列表中选择“ASP.NET Core Web 应用”模板，然后点击“下一步”。
3. 在“配置新项目”对话框中，输入项目名称（例如 MyEmptyWebApp），并选择项目保存位置。点击“创建”。

注意： 搜索时请确保选择的是“ASP.NET Core Web 应用”而非“ASP.NET Core Web API”或其他模板，因为我们要创建的是支持 MVC 框架的空项目。

选择项目类型

在“创建新的 ASP.NET Core Web 应用程序”向导中，需选择项目模板：

• 在模板列表中，选择“空”。
• 确认“身份验证类型”为“无”（可根据需要后续添加）。
• 点击“创建”。

小提示： 选择“空”模板后，项目仅包含最基础的文件（如 Program.cs、Startup.cs 和 .csproj），无预定义页面、控制器或视图，非常适合从头构建自定义应用。

配置项目

1. 在解决方案资源管理器中，右键点击项目名称，选择“属性”。
2. 在“应用程序”选项卡中，确认目标框架为所需的 .NET Core 版本（例如 .NET 6.0 或 .NET 8.0）。
3. 根据需要调整其他设置，如输出路径、启动项等。通常保持默认即可。

注意： 目标框架的选择会影响可用的 NuGet 包版本和 API 支持。建议使用最新的长期支持（LTS）版本。

添加依赖项

若项目需要使用特定 NuGet 包（例如 Entity Framework Core、Swagger 等），可通过以下步骤添加：

1. 在解决方案资源管理器中，右键点击项目名称，选择“管理 NuGet 包”。
2. 在 NuGet 包管理器中，切换到“浏览”选项卡。
3. 在搜索框中输入需要的包名称（例如 Microsoft.EntityFrameworkCore.SqlServer），选择对应包，然后点击“安装”。

小提示： 安装前请检查包是否与当前项目目标框架兼容。可在 NuGet 包详情页查看“依赖项”信息。

编写代码

创建控制器

1. 在解决方案资源管理器中，右键点击项目名称，选择“添加” -> “新建文件夹”，将文件夹命名为 Controllers。
2. 右键点击 Controllers 文件夹，选择“添加” -> “控制器”。
3. 在“添加控制器”向导中，选择控制器类型（例如“MVC 控制器 - 空”或“API 控制器 - 空”）。
4. 点击“添加”，按提示输入控制器名称（如 HomeController），然后点击“确定”。

注意： 若选择“API 控制器”，则控制器默认返回 JSON 数据；若选择“MVC 控制器”，则需要配合视图使用。

创建视图

1. 在解决方案资源管理器中，右键点击项目名称，选择“添加” -> “新建文件夹”，将文件夹命名为 Views。
2. 在 Views 文件夹下，再创建一个与控制器名称对应的子文件夹（例如 Home）。
3. 右键点击该子文件夹，选择“添加” -> “视图”。
4. 在“添加视图”对话框中，输入视图名称（如 Index），选择视图引擎（通常为 Razor (CSHTML)），并勾选“使用布局页”或保持默认。点击“添加”。

小提示： 使用空模板时，项目默认无布局页。可在 Views 文件夹下创建 _ViewStart.cshtml 和 _Layout.cshtml 来设置共享布局。

运行项目

完成代码编写后，可启动项目查看效果：

• 点击 Visual Studio 工具栏中的“启动”按钮（绿色三角形），或使用快捷键 Ctrl+F5（不带调试）或 F5（带调试）。
• 浏览器将自动打开，显示默认页面或 API 端点。若创建了控制器和视图，记得在 Startup.cs 或 Program.cs 中配置路由和终结点（例如添加 app.UseEndpoints 和 MapControllerRoute）。

注意： 空模板默认未配置 MVC 路由。需确保在 Startup.cs 的 ConfigureServices 方法中添加 services.AddControllersWithViews();，并在 Configure 方法中添加 app.UseRouting(); 和 app.UseEndpoints(endpoints => { endpoints.MapControllerRoute("default", "{controller=Home}/{action=Index}/{id?}"); });。

特色功能：空的 ASP.NET Core Web 项目有什么优势？

• 极简起点：仅包含最必要的文件（Program.cs、Startup.cs、.csproj），无多余模板代码，让你专注核心逻辑。
• 完全可控：可自由选择使用 MVC、Web API、Razor Pages 或其他框架，灵活添加依赖。
• 学习友好：适合初学者理解 ASP.NET Core 的请求管道、中间件、依赖注入等基础概念，而不被复杂模板干扰。
• 性能优化：由于不包含多余功能，启动速度和内存占用更优，适合构建微服务或轻量级 API。

常见问题与解答

Q1: 创建空项目后，运行时报错“HTTP Error 500.30 - ANCM In-Process Startup Failure”怎么办？

A： 这通常是因为 Program.cs 或 Startup.cs 中存在代码错误，或缺少必要的 NuGet 包。请检查：

• 确保 Program.cs 中调用了 CreateHostBuilder(args).Build().Run(); 且方法正确。
• 检查 appsettings.json 是否存在且格式正确。
• 尝试在 Visual Studio 的“输出”窗口中查看详细错误信息。

Q2: 我添加了控制器和视图，但访问页面时显示 404 错误？

A： 最常见原因是路由配置缺失。请确保在 Startup.cs 的 ConfigureServices 中添加了 services.AddControllersWithViews();，并在 Configure 中添加了 app.UseRouting(); 和 app.UseEndpoints(endpoints => { endpoints.MapControllerRoute("default", "{controller=Home}/{action=Index}/{id?}"); });。另外，检查控制器名称和视图文件夹名称是否匹配（例如控制器名为 HomeController，则视图文件夹应为 Views/Home）。

Q3: 如何将空项目转换为 MVC 项目？

A： 无需重新创建项目。只需手动添加以下内容：

• 在 Startup.cs 的 ConfigureServices 中添加 services.AddControllersWithViews();。
• 在 Configure 中添加路由中间件和终结点（如上所述）。
• 创建 Controllers 和 Views 文件夹，并添加控制器和视图。
• 可选：添加 wwwroot 文件夹用于静态文件，并在 Configure 中添加 app.UseStaticFiles();。

Q4: 空项目中没有 launchSettings.json 文件，如何配置启动 URL？

A： 空模板默认包含 launchSettings.json（位于 Properties 文件夹下）。若未生成，可手动创建，或在项目属性中设置“调试”选项卡的“启动浏览器”URL。右键项目 -> 属性 -> 调试，在“环境变量”中设置 ASPNETCORE_URLS 为所需地址（如 http://localhost:5000）。

总结

通过以上步骤，你可以在 Visual Studio 中成功创建一个空的 ASP.NET Core Web 项目，并逐步添加控制器、视图和依赖项。这种从零开始的方式让你深入理解框架的配置与运行机制，为后续开发复杂 Web 应用打下坚实基础。若在实践中遇到其他问题，欢迎查阅官方文档或在社区搜索相关解决方案。