关键在于选对模板、配对.net 10.0框架、禁用“不使用顶级语句”开关；需手动按语言（c#/f#）、平台（windows）、项目类型（如mvc/web api）三重筛选，命名大小写须与namespace严格一致，首次运行务必验证原始模板可执行。

直接用 Visual Studio 创建 Web 项目，关键不是“能不能”，而是选对模板、配对框架、避开默认陷阱——尤其是 .NET 版本和顶级语句开关这两个地方，错一个就可能编译失败或调试不进断点。

选模板时注意语言、平台、项目类型三重过滤

Visual Studio 不会自动推荐你真正需要的 Web 模板，得手动筛。打开“创建新项目”后，别只盯着搜索框输 ASP.NET 就点确定：

• 先在左侧语言栏选 C#（或 F#、JavaScript），否则可能捞出一堆 C++ 或 Python 模板
• 平台选 Windows（哪怕你目标是跨平台部署，VS 当前 Windows 版本的 Web 模板都挂在这个分类下）
• 项目类型选 Web，再从列表里挑具体类型：比如 ASP.NET Core Web API、ASP.NET Core Web App (MVC)、Vue 应用 或 React 应用
• 如果搜不到 Vue 或 React，说明没装对应工作负载——点“安装更多工具和功能”，勾上 Node.js 开发 或 ASP.NET 和 Web 开发

.NET 版本和“不使用顶级语句”必须同步检查

VS 新建向导里，“其他信息”页的两个选项是高频报错源：

Visual Studio Professional 18.8.1

Visual Studio 18.8.1 官方固定版本安装引导程序，当前条目使用微软发布历史中的 Professional Web Installer，适合旧项目兼容、环境回退、复现特定构建链和排查版本差异等场景。

下载

• .NET 10.0 是当前标准支持版本（截至 2026 年 8 月），选低了（如 .NET 8.0）可能缺新 API；选高了（如预览版）可能不稳定
• 务必确认“不使用顶级语句”复选框是 未勾选 状态——勾了会导致 Program.cs 生成传统类+Main结构，而新版模板依赖顶级语句语法，编译会报 CS8803: Top-level statements must precede namespace and type declarations
• 如果项目名用了 MvcMovie 这类命名，所有 namespace 必须严格匹配大小写，否则控制器路由 404

启动项目前先看控制台输出是否含 VITE 或 dotnet run 成功标识

按 F5 启动后，别急着开浏览器，先盯住底部“输出”窗口或弹出的命令提示符：

• 如果是 Vue/React 模板，应看到类似 VITE v4.4.9 ready in 780 ms 的日志，而不是卡在 npm install 或报 Node.js version 18.x required
• 如果是 ASP.NET Core 模板，应看到 Now listening on: https://localhost:5001 和 Application started. Press Ctrl+C to shut down.
• 若出现 Failed to load resource: net::ERR_CONNECTION_REFUSED，大概率是 HTTPS 开发证书没信任——运行 dotnet dev-certs https --trust 再重启
• 若页面空白但控制台无报错，检查浏览器地址栏是否被自动跳转到 http://（而项目只监听 https://），手动改成 https 即可

最常被忽略的是：新建完项目不要立刻改代码，先确保原始模板能跑通。很多“路由不生效”“API 返回 404”问题，根源其实是初始配置没过验证，而不是后续逻辑写错了。