如何在Visual Studio中设置ASP.NET Core 5应用启动时显示控制台窗口
恢复控制台模式启动并解决窗口最小化问题的操作方案
所有操作均在VS2022界面内完成,无需使用命令行手动启动项目:
- 检查全局ASP.NET Core调试配置
打开VS顶部菜单「工具」→「选项」→ 定位到「项目和解决方案」→「ASP.NET Core」分类,确认取消勾选「启动时自动最小化控制台窗口」选项。 - 确认项目启动配置
打开项目根目录下Properties/launchSettings.json文件,找到你日常使用的启动配置节点,确保以下配置值正确:
确认配置中不存在"自定义启动配置名称(默认和项目名一致)": { "commandName": "Project", // 必须为Project,不能填IISExpress "launchBrowser": true, // 可按需开启或关闭,不影响控制台窗口弹出 "applicationUrl": "http://localhost:5000;https://localhost:5001", "environmentVariables": { "ASPNETCORE_ENVIRONMENT": "Development" }, "launchWindow": true // 新增该配置,强制要求启动时显示控制台窗口 }"launchWindow": false的配置项,如有直接删除或修改为true即可。 - 校验项目输出类型
右键项目 → 选择「属性」→ 进入「应用」标签页,确认「输出类型」下拉框选中的是控制台应用,不是Windows应用或者类库。 - 调整多项目启动配置
如果你使用多项目批量启动:右键解决方案 → 选择「属性」→ 进入「通用属性-启动项目」→ 选中「多个启动项目」,确认对应ASP.NET Core项目的「操作」列为「启动」。VS2022对多项目启动场景默认会将非交互类项目的窗口最小化,你可以单独右键该项目选择「调试」→「启动新实例」,验证是否能正常弹出非最小化的控制台窗口。
仅ASP.NET Core项目启动时默认最小化的原因
- VS2022新增了Web项目启动优化逻辑:如果检测到项目为ASP.NET Core Web API类无前端页面的项目、且处于多项目批量启动场景下,会默认将控制台窗口初始状态设为最小化,避免同时弹出大量窗口挤占前台视图。
- 你使用的其他消息队列后台服务属于纯控制台应用,没有被VS归类到Web项目范畴,所以不会触发该优化逻辑,启动时会正常显示窗口。
- VS2019没有加入该优化逻辑,所以所有项目启动时窗口都会正常展示。
内容的提问来源于stack exchange,提问作者Modern Ronin
相关产品推荐
相关产品推荐

