vs code调试c#需同时安装c# dev kit扩展并配置匹配的.net 8+ sdk，否则断点不命中、f5无响应、状态栏显示；必须通过“file > open folder”打开含.csproj或.sln的目录，首次f5选“yes”自动生成launch.json。
VSCode 本身不能直接调试 C#，必须装 C# Dev Kit 扩展，并且本地得有匹配的 .NET SDK；缺一不可，否则断点不命中、F5 按下没反应、状态栏显示 <no project></no> 都是常态。
安装 C# Dev Kit 扩展后必须重启 VS Code
扩展市场搜 C# Dev Kit（发布者必须是 Microsoft），点安装。它会连带拉取 vscode-dotnet-runtime 和底层 OmniSharp，但这些组件只在重启窗口后才真正激活。
- 不重启 → 状态栏右下角不会出现
C# Dev Kit: Ready提示 - 不重启 → 即使打开
.cs文件，也看不到智能提示、跳转定义失效、F5报错 “No debug adapter found” - Mac 用户注意：重启前建议先关掉所有终端 tab，避免旧 shell 环境缓存错误的
DOTNET_ROOT
dotnet --version 输出必须 ≥ 8.0
C# Dev Kit 在 2026 年已默认要求 .NET 8+，低于此版本（比如只装了 7.0 或 6.0）会导致 OmniSharp 启动失败、项目加载卡在 “Loading…”、launch.json 中 program 字段路径解析为空。
- 运行
dotnet --version，输出应类似8.0.100；若报 command not found，去 dotnet.microsoft.com/download 下最新 SDK - Linux/macOS 用户装完 SDK 后，需确认
dotnet命令在终端全局可用（检查$PATH是否含/usr/share/dotnet或/usr/local/share/dotnet） - Windows 用户若用 Scoop/Chocolatey 安装，务必执行
scoop reset dotnet-sdk或refreshenv刷新环境变量
打开文件夹必须包含 .sln 或 .csproj
VSCode 不识别单个 .cs 文件为 C# 项目 —— 它靠 .sln 或 .csproj 文件触发 C# Dev Kit 的自动配置流程。没有它们，就永远是 <no project></no>。
- 新建项目请用
dotnet new console -o myapp，然后用 VSCode “File > Open Folder” 打开myapp根目录（不是打开Program.cs单文件） - 已有代码但无项目文件？在根目录手动运行
dotnet new sln+dotnet new console -n MyApp+dotnet sln add MyApp.csproj - 状态栏显示项目名（如
MyApp）和框架（如net8.0）才算真正就绪；此时再按F5才会自动生成有效.vscode/launch.json
第一次 F5 失败时别急着改 launch.json
刚打开项目时按 F5，VSCode 通常会弹窗问 “Required assets to build and debug are missing… Add them?”，选 Yes 即可。它会生成基础 launch.json 和 tasks.json，但关键字段依赖项目结构是否被正确识别。
- 如果点了 Yes 还报错，先检查
.csproj里<targetframework>net8.0</targetframework>是否与dotnet --version匹配 - 不要手动改
launch.json里的program路径为绝对路径——它应该保持相对形式："${workspaceFolder}/bin/Debug/net8.0/MyApp.dll" - 常见陷阱：
launch.json生成后，若你切换了构建配置（比如从Debug改成Release），需手动删掉bin/Debug目录并重新dotnet build，否则 DLL 路径不存在
最易被忽略的是：C# Dev Kit 的项目加载是异步的，状态栏变绿不代表 OmniSharp 已完成符号索引——大型解决方案可能需要 20–60 秒，期间断点灰色不可用、跳转失灵都属正常。等右下角提示 “C# Dev Kit: Ready” 且 CPU 占用回落，才是真就绪。
