vscode 本身不能直接运行 c# 代码，必须依赖本地安装的 .net sdk 和正确激活的 c# 扩展；跳过 sdk 安装或误用 runtime 会导致 dotnet run 报错、f5 调试失败、intellisense 不工作——这不是 vscode 配置问题，而是底层工具链缺失。
VSCode 本身不能直接运行 C# 代码，必须依赖本地安装的 .NET SDK 和正确激活的 C# 扩展；跳过 SDK 安装或误用 Runtime 会导致 dotnet run 报错、F5 调试失败、IntelliSense 不工作——这不是 VSCode 配置问题，而是底层工具链缺失。
必须装 .NET SDK，不是 Runtime
Runtime 只能运行已编译的程序，无法编译 .cs 文件或生成 .dll。VSCode 的调试、智能提示、项目加载全部依赖 SDK 中的 Roslyn 编译器和 dotnet CLI。
- Windows：去 dotnet.microsoft.com/download 下载带 “SDK” 字样的安装包（如
.NET SDK 8.0.400），**不要选 “ASP.NET Core Runtime” 或 “Desktop Runtime”** - macOS：用
brew install --cask dotnet-sdk，再执行xcode-select --install（否则dotnet build会报MSB4236） - Linux（Ubuntu/Debian）：按官方步骤添加源后运行
sudo apt install dotnet-sdk-8.0 libicu72 libssl3，路径默认是/usr/share/dotnet，不是/opt/dotnet
验证命令必须同时通过：
dotnet --version # 输出类似 8.0.400 dotnet --list-sdks # 输出类似 8.0.400 [/usr/share/dotnet/sdk]
C# 扩展只在有项目文件的目录才启动
打开单个 Program.cs 文件，C# 扩展显示 “C# features are disabled”，F5 必然失败。它需要 .csproj 或 .sln 来识别工作区边界和目标框架。
- 正确做法：
dotnet new console -n MyApp && cd MyApp && code .，然后在 VSCode 中用 File > Open Folder 打开整个MyApp目录 - 如果已错误打开单个文件：关闭窗口，重新以文件夹方式打开
- 扩展卡在 “Installing…”？看 Output 面板里的
OmniSharp Log，常见原因是dotnet命令不可用或路径未被识别
macOS 上首次加载可能下载约 100MB 的语言服务器工具，状态栏显示 “OmniSharp: Starting…” 是正常现象，别强制退出。
launch.json 的 program 必须指向 .dll，不是 .cs
VSCode 默认生成的 launch.json 里 "program": "${workspaceFolder}/bin/Debug/net8.0/MyApp.dll" 是对的；手动改成 MyApp.cs 或相对路径会触发 Cannot launch program; setting 'program' must be an absolute path to the executable 错误。
- 控制台项目加
"console": "integratedTerminal"，否则输出看不见 - ASP.NET Core 项目必须设
"env": { "ASPNETCORE_ENVIRONMENT": "Development" }，否则IConfiguration读不到appsettings.Development.json - Web 项目调试前需确认
bin/Debug/net8.0/MyApp.dll存在——如果没生成，先在终端跑dotnet build
终端里 dotnet 命令失效，不是环境变量没配
VSCode 集成终端启动时不会自动加载 Shell 配置文件（如 ~/.zshrc 或 $PROFILE），所以即使 PATH 已设好，终端里仍可能报 command not found。
- macOS：检查
~/.zshrc是否含export PATH="$PATH:/usr/local/share/dotnet"，然后在 VSCode 里按Cmd+Shift+P→ Developer: Restart Backend - Windows PowerShell：临时生效可运行
$env:Path += ";C:\Program Files\dotnet"，但更稳的是改系统环境变量并重启 VSCode - Linux：
which dotnet看实际路径，若为/usr/share/dotnet/dotnet，就别写成/opt/dotnet
最易被忽略的一点：VSCode 启动后，右下角状态栏必须显示 C# (LSP)（不是 OmniSharp），且 .NET 版本号（如 .NET 8.0.400）可见——这表示语言服务器已通过 dotnet CLI 正确接管，而非降级使用独立 OmniSharp 进程。
