VS Code 调试 C# 失败主因是未安装或未正确配置 C# Dev Kit：必须安装该扩展、重启窗口、用文件夹方式打开含 .csproj 的项目，并确保系统 PATH 包含 dotnet 可执行路径且已装对应 SDK。
VS Code 调试 C# 程序失败，90% 是因为没装 C# Dev Kit，或者装了但没重启、没指定 SDK 路径、没用文件夹方式打开项目——这几个环节缺一不可，不是“差不多能用”，而是“全对才通”。
为什么装了 C# 扩展还不能调试？
旧版 C# 扩展（OmniSharp）已不支持 .NET 8+ 的语言服务和热重载；C# Dev Kit 是当前唯一能自动识别 .csproj、生成 launch.json、启用 dotnet run 调试流的官方扩展。它不依赖 OmniSharp 进程，而是直接调用 dotnet CLI 启动语言服务器。
- 安装后必须点击弹窗里的“立即重启”或手动执行
Developer: Reload Window - 重启前状态栏右下角不会显示
C# (Dev Kit)或框架版本（如net8.0） - 如果只装了旧版
C#扩展，即使有.NET SDK，F5 也会报No debug adapter found
dotnet 命令在 VS Code 终端里找不到怎么办？
这不是 VS Code 没配好，是系统 PATH 根本没包含 dotnet 可执行路径。VS Code 启动时继承的是 shell 的初始环境变量，改完 ~/.zshrc 或系统 PATH 后，必须彻底退出 VS Code 再重开，不能只关窗口。
- macOS：检查
~/.zshrc是否有export PATH="$PATH:/usr/local/share/dotnet"（Homebrew 安装则可能是/opt/homebrew/share/dotnet） - Windows：确认系统环境变量
PATH包含C:\Program Files\dotnet，用where dotnet验证 - Linux：
sudo apt install dotnet-sdk-8.0默认路径是/usr/share/dotnet，不是/opt/dotnet - 验证方式：在 VS Code 新建终端（不要复用旧 tab），运行
dotnet --list-sdks，必须看到类似8.0.200 [/usr/local/share/dotnet/sdk]
按 F5 没反应、断点不命中、状态栏显示
VS Code 不会把单个 Program.cs 当作项目——它只靠 .sln 或 .csproj 文件触发 C# Dev Kit 的项目加载流程。没有它们，就永远是纯文本编辑模式。
- 必须用
File > Open Folder打开含.csproj的目录（例如myapp/），不是双击打开Program.cs - 已有代码但无项目文件？在根目录运行：
dotnet new sln && dotnet new console -n MyApp && dotnet sln add MyApp.csproj - 首次按 F5 时弹出 “Required assets to build and debug are missing…” → 一定选
Yes，它会生成.vscode/launch.json和tasks.json - 如果
.csproj中<targetframework></targetframework>是net6.0，但只装了 .NET 8 SDK，项目会静默加载失败，状态栏仍显示<no project></no>
launch.json 自动生成但调试失败？重点检查这三项
C# Dev Kit 生成的 launch.json 是基础模板，但关键字段缺失或错位会导致启动失败、控制台一闪而过、或无法附加到进程。
-
program字段必须指向编译后的 DLL，例如"${workspaceFolder}/bin/Debug/net8.0/MyApp.dll"，不是.cs文件或未构建的路径 - 控制台程序务必加
"console": "integratedTerminal"，否则输出看不到，也收不到Console.ReadKey() - ASP.NET Core 项目必须设
"env": { "ASPNETCORE_ENVIRONMENT": "Development" }，否则读不到appsettings.Development.json - 多个
.csproj时，VS Code 可能默认选错启动项目 → 按Ctrl+Shift+P运行C# Dev Kit: Select Startup Project手动指定
最容易被忽略的是：C# Dev Kit 不会帮你装 .NET SDK，也不会自动修复 PATH；它只做检测和协调。所有底层依赖都得先在系统层面跑通，再进 VS Code —— 这一步跳不过，也绕不开。
