C# Dev Kit是VS Code调试C#的必要前提，非可选插件；需重启VS Code以激活全部功能，确保OmniSharp加载、.csproj解析及状态栏图标显示，并手动指定.NET SDK路径（如/opt/homebrew/share/dotnet或C:\Program Files\dotnet），同时验证dotnet --list-sdks输出、项目TargetFramework匹配及Debug配置生效。
C# Dev Kit 不是“可选插件”，而是当前 VS Code 调试 C# 的必要前提；单独装旧版 C# 扩展（OmniSharp）已无法自动配置调试器、生成 launch.json，也无法支持 .NET 8+ 热重载等关键能力。
安装 C# Dev Kit 扩展时，别跳过重启步骤
VS Code 安装扩展后不会立即激活全部功能，尤其是 C# Dev Kit 这类依赖进程注入和语言服务器初始化的扩展。不重启窗口会导致 OmniSharp 后端未加载、.csproj 文件无法解析、状态栏不显示 C# (Dev Kit) 图标。
- 安装完成后务必点击弹出提示中的“立即重启”按钮，或手动执行
Developer: Reload Window - macOS 用户若使用 Homebrew 安装 .NET SDK，路径常为
/opt/homebrew/share/dotnet，C# Dev Kit 可能默认找不到——重启后按Cmd+Shift+P输入C#: Select .NET SDK手动指定 - Windows 上通过 WinGet 安装的 SDK（如
dotnet-sdk包），路径通常在C:\Program Files\dotnet，同样需确认是否被识别
dotnet --list-sdks 无输出？不是扩展问题，是环境根本没就位
看到 “无法找到 .NET SDK” 提示时，90% 情况下不是 VS Code 配置错了，而是终端里压根没装 SDK 或 PATH 没生效。C# Dev Kit 不会帮你装 .NET，它只检测。
- 先在系统终端（不是 VS Code 内置终端）运行
dotnet --list-sdks，确认有类似8.0.200 [/usr/local/share/dotnet/sdk]的输出 - 若报
command not found，说明dotnet命令不在 PATH 中：macOS 检查~/.zshrc是否追加了export PATH="$PATH:/usr/local/share/dotnet"；Windows 检查系统环境变量中PATH是否含C:\Program Files\dotnet - VS Code 内置终端可能缓存旧 shell 环境，重启 VS Code 后再打开终端，或直接用
Terminal: Create New Terminal（而非复用旧 tab）
调试启动失败：检查 launch.json 生成逻辑和项目配置
C# Dev Kit 在首次打开含 .sln 或 .csproj 的文件夹时，会自动生成 .vscode/launch.json。但这个过程依赖两个隐性条件：项目必须处于 Debug 配置，且 .csproj 中的 <targetframework></targetframework> 必须匹配已安装 SDK 版本。
- 打开
.csproj，确认存在类似<targetframework>net8.0</targetframework>的节点；若写的是net6.0但只装了 .NET 8 SDK，OmniSharp 将静默失败，不报错但调试按钮灰掉 - 确保当前构建配置是
Debug：右下角状态栏应显示Debug（非Release），否则dotnet build不生成.pdb符号文件，调试器无法命中断点 - 若
.vscode/launch.json不存在，不要手动创建——先关闭文件夹，再用File > Open Folder...重新打开项目根目录，触发自动配置
IntelliSense 卡顿或跳转失效，优先重启 OmniSharp 而非重装扩展
补全失灵、F12 跳转失败、红色波浪线不消失，多数时候是 OmniSharp 进程卡死或缓存污染，跟扩展本身无关。
- 快捷键
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入C#: Restart OmniSharp并执行 - 若仍无效，在命令面板运行
Developer: Toggle Developer Tools，切换到 Console 标签页，搜索关键词Failed to load project或MSBuild错误，定位具体是哪个.csproj解析失败 - 避免频繁切换 SDK 版本：每次手动调用
C#: Select .NET SDK都会清空 OmniSharp 缓存并重载，频繁操作反而加剧卡顿
真正麻烦的从来不是装几个扩展，而是 dotnet 命令能否在任意终端里稳定响应、项目文件是否被 OmniSharp 正确加载、以及 Debug 配置是否实际生效——这三处任一环节断开，调试流程就会静默中断，且错误提示极不直观。
