需安装.NET SDK、VSCode及C#扩展、配置OmniSharp路径、创建C#项目并设置launch.json调试文件,方可完成macOS Sequoia下VSCode的C#开发环境配置。

如果您希望在 Visual Studio Code 中进行 C# 和 .NET 应用程序开发,但尚未配置好相关工具链,则可能是由于缺少 .NET SDK、C# 扩展或调试环境支持。以下是完成该开发环境配置的步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装 .NET SDK
VSCode 本身不包含 .NET 运行时与编译器,必须单独安装官方 .NET SDK 才能编译和运行 C# 项目。SDK 提供了 dotnet CLI 工具、编译器(Roslyn)、运行时及基础类库。
1、访问 https://dotnet.microsoft.com/zh-cn/download 页面。
2、选择与 macOS Sequoia 兼容的最新稳定版 .NET SDK(如 .NET 8.x),下载 .pkg 安装包。
3、双击安装包,按向导完成安装。
4、打开终端,执行 dotnet --version 验证是否输出版本号。
二、安装 VSCode 与 C# 扩展
C# 扩展为 VSCode 提供语法高亮、智能提示(IntelliSense)、代码跳转、调试集成等核心功能,依赖 OmniSharp 语言服务器提供后端支持。
1、前往 https://code.visualstudio.com/Download 下载并安装 VSCode 正式版。
2、启动 VSCode,点击左侧活动栏的扩展图标(或按 Cmd+Shift+X)。
3、在搜索框中输入 C#,找到由 Microsoft 发布的官方扩展(ID:ms-dotnettools.csharp)。
4、点击“安装”,安装完成后重启 VSCode。
三、配置 OmniSharp 后端模式
OmniSharp 是 C# 扩展的语言服务核心,支持两种运行模式:内置进程(默认)与外部 .NET 运行时托管。当项目使用较新 SDK 或存在多目标框架时,需显式指定 SDK 路径以避免解析失败。
1、在 VSCode 中按下 Cmd+, 打开设置界面。
2、在右上角点击“打开设置(JSON)”图标,进入 settings.json 编辑模式。
3、添加以下键值对:"omnisharp.useGlobalMono": "never"。
4、再添加:"omnisharp.dotnetPath": "/usr/local/share/dotnet"(路径需与实际 SDK 安装位置一致,可通过 which dotnet 查看)。
四、创建并初始化 C# 项目
通过 dotnet CLI 初始化项目可确保项目文件结构、SDK 版本声明及依赖项均符合当前 .NET 环境规范,避免手动创建时遗漏关键配置。
1、在终端中新建目录并进入:mkdir MyConsoleApp && cd MyConsoleApp。
2、执行命令创建控制台项目:dotnet new console。
3、在当前目录中打开 VSCode:code .。
4、等待右下角出现 OmniSharp: Ready 提示,表示语言服务已加载完成。
五、启用调试配置
VSCode 默认不包含调试启动配置,需手动创建 launch.json 文件以定义调试器行为,包括启动方式、目标程序集、参数及环境变量。
1、在 VSCode 中按下 Cmd+Shift+D 切换到运行与调试视图。
2、点击“创建 launch.json 文件”,选择环境为 .NET Core。
3、在生成的 .vscode/launch.json 中确认 "program" 字段指向 bin/Debug/net8.0/MyConsoleApp.dll(路径需与实际项目名和目标框架匹配)。
4、按 F5 启动调试,验证断点命中与变量监视功能是否正常工作。










