在 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 开发”。
- 点击“修改”按钮，等待安装完成。
小提示： 若已安装该工作负载但不确定完整性，可重新运行安装程序，勾选后确认状态显示为“已安装”。
创建项目
- 打开 Visual Studio，在启动窗口中选择“创建新项目”。
- 在搜索框中输入
asp.net core web 应用，从结果列表中选择“ASP.NET Core Web 应用”模板，然后点击“下一步”。 - 在“配置新项目”对话框中，输入项目名称（例如
MyEmptyWebApp），并选择项目保存位置。点击“创建”。
注意： 搜索时请确保选择的是“ASP.NET Core Web 应用”而非“ASP.NET Core Web API”或其他模板，因为我们要创建的是支持 MVC 框架的空项目。
选择项目类型
在“创建新的 ASP.NET Core Web 应用程序”向导中，需选择项目模板：
- 在模板列表中，选择“空”。
- 确认“身份验证类型”为“无”（可根据需要后续添加）。
- 点击“创建”。
小提示： 选择“空”模板后，项目仅包含最基础的文件（如 Program.cs、Startup.cs 和 .csproj），无预定义页面、控制器或视图，非常适合从头构建自定义应用。
配置项目
- 在解决方案资源管理器中，右键点击项目名称，选择“属性”。
- 在“应用程序”选项卡中，确认目标框架为所需的 .NET Core 版本（例如 .NET 6.0 或 .NET 8.0）。
- 根据需要调整其他设置，如输出路径、启动项等。通常保持默认即可。
注意： 目标框架的选择会影响可用的 NuGet 包版本和 API 支持。建议使用最新的长期支持（LTS）版本。
添加依赖项
若项目需要使用特定 NuGet 包（例如 Entity Framework Core、Swagger 等），可通过以下步骤添加：
- 在解决方案资源管理器中，右键点击项目名称，选择“管理 NuGet 包”。
- 在 NuGet 包管理器中，切换到“浏览”选项卡。
- 在搜索框中输入需要的包名称（例如
Microsoft.EntityFrameworkCore.SqlServer），选择对应包，然后点击“安装”。
小提示： 安装前请检查包是否与当前项目目标框架兼容。可在 NuGet 包详情页查看“依赖项”信息。
编写代码
创建控制器
- 在解决方案资源管理器中，右键点击项目名称，选择“添加” -> “新建文件夹”，将文件夹命名为
Controllers。 - 右键点击
Controllers文件夹，选择“添加” -> “控制器”。 - 在“添加控制器”向导中，选择控制器类型（例如“MVC 控制器 - 空”或“API 控制器 - 空”）。
- 点击“添加”，按提示输入控制器名称（如
HomeController），然后点击“确定”。
注意： 若选择“API 控制器”，则控制器默认返回 JSON 数据；若选择“MVC 控制器”，则需要配合视图使用。
创建视图
- 在解决方案资源管理器中，右键点击项目名称，选择“添加” -> “新建文件夹”，将文件夹命名为
Views。 - 在
Views文件夹下，再创建一个与控制器名称对应的子文件夹（例如Home）。 - 右键点击该子文件夹，选择“添加” -> “视图”。
- 在“添加视图”对话框中，输入视图名称（如
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 为所需地址（如 https://localhost:5000）。
总结
通过以上步骤，你可以在 Visual Studio 中成功创建一个空的 ASP.NET Core Web 项目，并逐步添加控制器、视图和依赖项。这种从零开始的方式让你深入理解框架的配置与运行机制，为后续开发复杂 Web 应用打下坚实基础。若在实践中遇到其他问题，欢迎查阅官方文档或在社区搜索相关解决方案。
