VSCode运行C#代码必须基于.csproj项目结构且安装匹配.NET SDK，否则F5调试失败、IntelliSense失效；需用Open Folder打开项目根目录而非单个.cs文件，并配置正确launch.json路径与console选项。
VSCode 不能直接运行单个 .cs 文件，必须基于含 .csproj 的项目结构，且本地已安装匹配的 .NET SDK —— 这是 90% 的“运行失败”“F5 无反应”“IntelliSense 红波浪线”的根源。
dotnet --version 有输出，但 VSCode 里 C# 功能仍被禁用
这不是插件没装，而是 VSCode 没识别到项目上下文。C# 扩展（OmniSharp 或 C# Dev Kit）只在打开含 .csproj、.sln 或 global.json 的文件夹时才激活语言服务。
- 错误操作：双击
Program.cs单独打开 → 状态栏显示 “C# features are disabled” - 正确做法：终端执行
dotnet new console -n MyApp，然后在 VSCode 中用 File > Open Folder 打开MyApp文件夹（不是里面任何文件） - 验证就绪：状态栏右下角出现 “C# (LSP)” 或 “OmniSharp: Ready”，且
Console.WriteLine不报错 - 已误操作？关闭所有窗口，删掉项目根目录下的
.vscode文件夹，重来
按 F5 调试报 “Could not find debug adapter for type 'coreclr'”
本质是调试器找不到可执行目标，常见于 .csproj 与 launch.json 中框架版本或路径不一致。
- 检查
.csproj中的<TargetFramework>，例如net8.0 - 运行
dotnet --list-sdks，确认该版本（如8.0.400）已安装且路径有效 - 打开
.vscode/launch.json，确保"program"字段指向编译后的 DLL，例如："${workspaceFolder}/bin/Debug/net8.0/MyApp.dll"—— 绝对不能是MyApp.cs或相对路径 - macOS 用户额外检查：
xcode-select --install是否执行过，否则dotnet build会静默失败，导致 DLL 根本没生成
dotnet run 成功，但 F5 调试一闪而过或无输出
控制台程序默认使用外部终端，VSCode 调试器无法捕获输出，除非显式指定控制台类型。
- 在
launch.json的配置项中加入："console": "integratedTerminal" - ASP.NET Core 项目还需加环境变量：
"env": { "ASPNETCORE_ENVIRONMENT": "Development" }，否则中间件（如appsettings.Development.json）不加载 -
dotnet run是命令行快速验证，自动跳过缓存的 build；F5 是完整调试流程，每次都会强制 rebuild，别用它反复测逻辑
OmniSharp 卡在 “Starting…” 或 macOS Sequoia 上反复崩溃
不是网络慢，而是 SDK 路径未被识别，或旧版 OmniSharp 与 .NET 8+ 冲突 —— 尤其在 macOS Sequoia 和 .NET SDK 8.0.302+ 上高频出现。
- 打开 VSCode 设置（
Cmd+,或Ctrl+,），搜索omnisharp.useGlobalMono，设为never - 再搜索
csharp.extension.autoStart，关掉它 - 手动指定 SDK 路径：在
settings.json中添加"omnisharp.dotnetPath": "/usr/local/share/dotnet"（路径用which dotnet确认） - 重启 VSCode 后，看右下角是否显示 “.NET 8.0.xxxx” 提示，而非 “OmniSharp” 字样
最易被忽略的一点：VSCode 集成终端启动时可能未加载 Shell 配置（如 ~/.zshrc），导致 dotnet 命令在终端里可用，但在 VSCode 内置终端里报 “command not found”。别急着重装，先用 Cmd+Shift+P → “Developer: Restart Backend”，再新开终端验证。
