正确配置VSCode C#开发环境需依次完成：一、安装并验证.NET SDK；二、启用C#扩展及OmniSharp设置；三、生成launch.json实现调试；四、安装Razor扩展支持Web开发；五、排查修复OmniSharp启动失败问题。
如果您希望在 Visual Studio Code 中高效进行 C# 开发，但发现缺少 IntelliSense、调试支持或项目加载失败，则可能是由于 .NET SDK、C# 扩展或工作区配置未正确协同工作。以下是完成 VSCode C# 开发环境核心配置的多种方法：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 .NET SDK 与验证环境
VSCode 本身不包含 .NET 运行时或编译器，必须单独安装匹配版本的 .NET SDK，且需确保终端可识别 dotnet 命令。此步骤是所有后续配置生效的前提。
1、访问 https://dotnet.microsoft.com/download，下载并安装最新稳定版 .NET SDK（推荐 .NET 8 SDK）。
2、打开终端，执行 dotnet --version，确认输出为已安装的 SDK 版本号（如 8.0.400）。
3、执行 dotnet --list-sdks，检查列表中是否包含至少一个 SDK 路径条目。
二、启用 C# 扩展与语言服务器
C# 扩展（由 OmniSharp 提供支持）负责代码补全、跳转、错误诊断等核心语言功能。它依赖于本地 .NET SDK，并需正确指向 SDK 安装路径。
1、在 VSCode 扩展市场中搜索并安装官方扩展：C# for Visual Studio Code (powered by OmniSharp)。
2、打开 VSCode 设置（Cmd+,），搜索 omnisharp.useGlobalMono，将其设为 always。
3、在设置中搜索 omnisharp.path，留空以启用自动发现；若自动失败，可手动指定为 /usr/local/share/dotnet/dotnet（macOS 默认路径）。
三、配置 launch.json 与调试支持
调试功能依赖 launch.json 文件定义启动行为，包括目标程序集、运行时参数及环境变量。缺失该文件将导致“无法启动调试会话”错误。
1、在项目根目录下，按 Cmd+Shift+P 打开命令面板，输入并选择 .NET: Generate Assets for Build and Debug。
2、确认项目含 .csproj 文件后，VSCode 将自动生成 .vscode/launch.json 和 tasks.json。
3、打开 .vscode/launch.json，检查 program 字段是否指向 bin/Debug/net8.0/[ProjectName].dll，且 console 值为 integratedTerminal。
四、启用 Razor 与 ASP.NET Core 支持
若开发 Web 项目（如 Blazor 或 MVC），需额外启用 Razor 语言服务，否则 .razor 文件无语法高亮、组件跳转和属性提示。
1、安装扩展：Razor Language Services（由 Microsoft 官方发布）。
2、在 settings.json 中添加配置项："razor.trace": "messages" 用于排查初始化问题。
3、重启 VSCode 后，打开任意 .razor 文件，等待右下角状态栏显示 Razor Language Server is ready。
五、修复 OmniSharp 启动失败
OmniSharp 启动失败常表现为“Loading…”长时间不结束或报错“Failed to start OmniSharp”，多数由 SDK 路径冲突或权限问题引发。
1、在 VSCode 中按 Cmd+Shift+P，运行 OmniSharp: Restart OmniSharp。
2、若仍失败，在终端中执行 dotnet tool install --global OmniSharp.Utils，再重试启动。
3、检查项目根目录是否存在 global.json；如有，确认其中 sdk.version 与已安装 SDK 版本一致，或直接删除该文件启用自动匹配。
