当前位置:

首页 > 使用技巧 > Visual Studio如何创建空的ASP.NET Core Web项目

Visual Studio如何创建空的ASP.NET Core Web项目

Visual Studio Code macOS版
Visual Studio Code macOS版

Visual Studio Code 是微软提供的免费代码编辑器,支持 macOS,并为 Intel 与 Apple 芯片 Mac 提供适配版本。软件集代码编辑、调试、Git 源代码管理、集成终端和扩展市场于一体。

立即下载
macOS 2026-10-13
数据库 编程开发 VS Code 服务器管理 装机必备

在VisualStudio中创建空的ASP.NETCoreWeb项目需先安装ASP.NET和Web开发工作负载,然后选择空模板创建项目。空项目仅包含基础文件,需手动配置路由和中间件,添加控制器和视图,后续可按需安装NuGet包。该方法提供极简起点,便于完全掌控结构和学习框架核心概念。

本文目录

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

    Visual Studio 是一款功能强大的集成开发环境,能够帮助开发者高效地创建各种类型的项目。对于刚刚接触 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 应用打下坚实基础。如果在实践过程中遇到其他问题,欢迎查阅官方文档或在社区中搜索相关解决方案。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    使用技巧 visual
    相关文章 更多
    Visual Studio如何新建空项目
    Visual Studio如何新建空项目

    在使用visual studio进行开发时,新建空项目是一个常见的操作。以下将详细介绍其具体步骤。打开visual studio双击桌面上的visual studio图标,启动该软件。创建新项目1. 在启动界面中,选择“创建新项目”。若已进入visual studio界面,可通过菜单栏中的“文件”-

    Visual Studio如何打印代码
    Visual Studio如何打印代码

    在visual studio中打印代码是一项常见需求,掌握正确的方法能方便我们获取清晰的代码文档。首先,打开需要打印的文件。确保代码已完整无误且格式符合预期,这样打印出来的效果才更理想。然后,进行打印设置。点击菜单栏中的“文件”选项,在下拉菜单中选择“打印”。这会弹出打印设置窗口。在打印设置窗口中,

    Visual Studio Code如何实现多处同时编辑
    Visual Studio Code如何实现多处同时编辑

    visual studio code是一款功能强大的开源代码编辑器,它支持同时编辑多处代码,这对于提高开发效率非常有帮助。以下是关于如何在visual studio code中同时编辑多处的方法。首先,打开visual studio code并打开你要编辑的项目。如果你有多个文件需要同时编辑,可以在

    Visual Studio Code编译python画布闪现如何解决
    Visual Studio Code编译python画布闪现如何解决

    在使用visual studio code编译python代码时,画布闪现是一个常见的困扰。当运行包含图形绘制等操作的python脚本时,窗口可能瞬间出现又消失,无法正常展示绘制结果。先来说说,这有可能是脚本执行完就自动把窗口给关了。咱可以在代码结尾处加点暂停的语句,像用`input()`函数就行。

    Visual Studio如何开启和关闭垂直滚动条缩略图模式
    Visual Studio如何开启和关闭垂直滚动条缩略图模式

    在visual studio开发环境中,垂直滚动条缩略图模式为开发者提供了一种方便浏览长文档或代码文件的方式。下面将详细介绍如何开启和关闭此模式。开启垂直滚动条缩略图模式要开启visual studio的垂直滚动条缩略图模式,可以按照以下步骤操作:步骤一:打开visual studio启动visua

    Visual Studio Code如何安装内置浏览器
    Visual Studio Code如何安装内置浏览器

    visual studio code(简称vs code)是一款广受欢迎的开源代码编辑器,它为开发者提供了丰富的功能和便捷的开发体验。其中,内置浏览器功能更是为开发者带来了极大的便利。那么,如何安装并使用vs code的内置浏览器呢?首先,确保你已经安装了vs code。如果还没有安装,可以前往官方

    Visual Studio如何在网页显示登录用户的昵称
    Visual Studio如何在网页显示登录用户的昵称

    在visual studio开发的网页中显示登录用户的昵称,能为用户带来更个性化的体验。以下从几个关键方面来实现这一功能。一、用户登录信息的存储用户一旦完成登录,昵称这类基础资料就得顺手保存下来,后续页面展示、状态识别都会用到。比较常见的做法,是借助会话(session)先把这些信息临时存起来。也就

    Visual Studio Code英文版如何显示隐藏行号
    Visual Studio Code英文版如何显示隐藏行号

    在使用 Visual Studio Code 英文版写代码的时候,行号这个小东西,实际上对定位和阅读代码帮助不小。问题来了——怎么把它显示出来,或者干脆藏起来呢? 先说显示行号,操作其实很简单。打开 VS Code 后,点一下菜单栏里的“View”(查看)。下拉菜单里有个“Show Line Num

    Visual Studio Code如何绘制流程图
    Visual Studio Code如何绘制流程图

    聊到VS Code,很多人只知道它是写代码的神器,但其实,配合几个扩展,它也能变成轻量级的流程图绘制工具。今天就来聊聊怎么用VS Code搞定这件事,整个过程比想象中要顺滑得多。 先做准备工作:打开VS Code,在扩展商店里搜一下“draw.io integration”,找到那个由hediet开

    Visual Studio如何设置同名变量或函数高亮显示
    Visual Studio如何设置同名变量或函数高亮显示

    在VisualStudio中,通过“工具”菜单进入“选项”,在“文本编辑器”下选择对应编程语言,找到“突出显示”设置,为同名变量或函数指定醒目颜色,即可实现高亮显示。也可通过悬停或快捷键临时高亮,提升代码可读性与开发效率。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。

    即将离开本站
    您即将前往第三方网站,请确认是否继续?