VS Code 写 C# 需 omnisharp-vscode 扩展 + .NET SDK；Windows/macOS 差异在于 SDK 安装方式、终端权限与路径行为，需验证 PATH、架构匹配及重启终端，手动配置 omnisharp.dotnetPath 并设 launch.json 的 console 为 externalTerminal（macOS 必须）。
VS Code 本身不内置 C# 支持，必须靠 omnisharp-vscode 扩展 + .NET SDK 配合才能真正写、编译、调试 C# 项目。Windows 和 macOS 的核心差异不在 VS Code 本身，而在于 .NET SDK 安装方式、终端权限模型和路径行为——这些会直接导致 dotnet 命令不可用、Omnisharp 启动失败或调试器连不上。
安装 .NET SDK：别只点下载，要验证 PATH 和架构匹配
Windows 用户通常用官方 Installer（.exe），默认勾选“将 dotnet 添加到 PATH”，但若手动勾掉或装在非系统盘，需手动把 C:\Program Files\dotnet 加入系统环境变量；macOS 用户用 Homebrew（brew install dotnet-sdk）最稳，如果从官网下 .pkg 安装，务必确认是否为 Apple Silicon（arm64）或 Intel（x64）版本——M1/M2 Mac 装 x64 版本会导致 dotnet --version 报错或 OmniSharp 进程崩溃。
- 装完后必须在新终端/命令提示符中运行
dotnet --version，不是 PowerShell 或 Terminal 里随便开个窗口，而是关闭再重开——旧 shell 不会自动加载新 PATH - macOS 上若用 zsh（默认），检查
~/.zshrc是否有export PATH="$PATH:/usr/local/share/dotnet"；若用 bash，改~/.bash_profile - Windows 用户遇到
The term 'dotnet' is not recognized，八成是没重启终端，或安装时没勾选 PATH，而不是扩展没装好
配置 OmniSharp：不要依赖自动发现，手动指定 SDK 路径更可靠
omnisharp-vscode 扩展默认尝试自动找 dotnet，但在多 SDK 环境（比如同时装了 .NET 6、7、8）或 macOS 自定义路径下容易选错。VS Code 设置里加一条 "omnisharp.useGlobalMono": "never" 强制走 .NET SDK 模式，再配 "omnisharp.dotnetPath" 显式指向 SDK 根目录。
- Windows 示例值：
"omnisharp.dotnetPath": "C:\\Program Files\\dotnet" - macOS 示例值：
"omnisharp.dotnetPath": "/usr/local/share/dotnet"（Homebrew）或"/usr/share/dotnet"（.pkg） - 路径末尾不能带
dotnet.exe或dotnet可执行文件名，只填 SDK 安装根目录 - 改完设置后必须重启 VS Code，不是重载窗口——OmniSharp 进程启动只发生在首次打开工作区时
调试 C# 控制台项目：launch.json 的 console 字段在 macOS 上必须设为 externalTerminal
Windows 默认用 integratedTerminal 调试没问题，但 macOS 的 integratedTerminal（VS Code 内置终端）无法正确继承 DOTNET_ROOT 和某些调试所需环境变量，导致 Could not resolve coreclr path 或程序一闪退出。必须显式在 .vscode/launch.json 中指定：
{
"configurations": [
{
"name": ".NET Core Launch (console)",
"type": "coreclr",
"request": "launch",
"preLaunchTask": "build",
"program": "${workspaceFolder}/bin/Debug/net8.0/MyApp.dll",
"args": [],
"stopAtEntry": false,
"console": "externalTerminal"
}
]
}-
externalTerminal会调用系统 Terminal.app，环境变量完整，且支持键盘输入（Console.ReadLine()才不会卡住） - Windows 用户可保留
integratedTerminal，但若项目含原生依赖（如 SQLitePCLRaw），也建议统一用externalTerminal避免 DLL 加载失败 - 别漏掉
preLaunchTask，否则调试前不会自动编译，容易误以为断点不命中
最容易被忽略的是：macOS 上每次升级 Xcode Command Line Tools（xcode-select --install）后，dotnet 可能突然报 Failed to initialize CoreCLR——这是因为 .NET SDK 依赖的系统 OpenSSL 或 ICU 库路径变了，此时需要重装 .NET SDK（不是修复），或者临时用 export DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=1 绕过本地化库加载（仅开发调试用）。
