<p>先选对模板再构建调试：写桌面工具选WPF Application（C# + .NET 10.0），网站选ASP.NET Core Web App，搜不到则通过“Tools > Get Tools and Features”安装对应工作负载；F5报错需确认启动项目、手动构建（Ctrl+Shift+B）及Debug模式；断点无效常因未保存、非Debug模式或“仅我的代码”启用。</p>

刚装好 Visual Studio，打开后面对一堆菜单和窗口不知从哪下手？别急，它不是要你立刻搞懂所有功能，而是先让你能跑通“写 → 编译 → 调试”这一条最短路径。下面几步直接对应你此刻最可能卡住的位置。

新建项目时选错模板，根本跑不起来

很多人点开“创建新项目”就懵——C#、C++、.NET 5、.NET 10、ASP.NET Core、WPF、WinUI……全堆在一起。关键不是学完再选，而是根据你要写的程序类型反向锁定：

• 想写桌面小工具（比如带按钮和列表的窗口）→ 搜 WPF Application，选 C# + .NET 10.0（长期支持）
• 想搭一个能用浏览器访问的网站 → 搜 ASP.NET Core Web App (Razor Pages)，同样选 .NET 10.0
• 想写传统 Windows 程序（如记事本风格）→ 搜 WinUI 空白应用(打包)，但必须确认已安装 WinUI 应用程序开发 工作负载
• 如果搜不到模板 → 别反复刷新，直接去 Tools > Get Tools and Features，勾选对应工作负载后点 Modify，重启 VS

代码写了，但按 F5 报错：“找不到启动项目”或“无法启动调试”

VS 不像记事本那样“保存即运行”，它需要明确知道哪个项目是入口。常见原因有三个：

Visual Studio Professional 18.8.1

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

下载

• 解决方案里有多个项目，但没设为“启动项目” → 在 解决方案资源管理器 中右键点击你的主项目（通常是名字最长、含 MainWindow 或 Program.cs 的那个），选 设为启动项目
• 项目还没生成过 → 先按 Ctrl + Shift + B 手动构建一次，看输出窗口有没有 Build succeeded，没有就说明引用或语法有硬伤
• 调试配置被意外改过 → 点顶部菜单栏 调试 > 调试属性，检查 启动对象 是否为空，启动项目 是否指向正确项目

断点打了，F5 启动后却跳不过去

断点灰色、提示“未命中”、或者直接忽略，基本不是代码问题，而是调试环境没对齐：

• 确认你当前是 Debug 模式（不是 Release）→ 看顶部工具栏左上角下拉框，必须是 Debug
• C# / ASP.NET Core 项目默认启用“仅我的代码”，会跳过框架内部调用 → 进入 工具 > 选项 > 调试 > 常规，取消勾选 启用仅我的代码
• 修改了代码但没保存 → VS 不会自动保存文件，断点打在未保存的缓冲区里，按 Ctrl + S 再试
• ASP.NET Core 的 Privacy.cshtml.cs 里加断点没反应 → 因为 Razor 页面默认编译为动态类，需确保 OnGet 方法里有可执行语句（比如加一行 int x = 1;），纯空方法会被优化掉

真正卡住的往往不是“怎么用”，而是“为什么没反应”。VS 的很多行为都依赖隐式状态：当前模式、启动项目、构建结果、调试符号是否加载……这些不会弹窗提醒，但每一步都得手动确认。先让一个最小项目跑通，比读十页文档更管用。