C# Dev Kit 扩展是解决 VSCode 中 .NET SDK 管理、调试、测试和部署缺失问题的关键,需依次安装启用、初始化项目、配置调试、运行测试、启用代码导航、发布应用。

如果您在 Visual Studio Code 中开发 C# 项目,但缺少对 .NET SDK 管理、调试、测试和部署的统一支持,则可能是由于未启用或未正确配置 C# Dev Kit 扩展。以下是构建完整 .NET 开发流程的具体操作步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、安装并启用 C# Dev Kit 扩展
C# Dev Kit 是微软官方推出的集成开发增强套件,它整合了 C# 语言服务、.NET 工具链感知、解决方案导航与项目模板等功能,替代传统独立 C# 扩展,提供开箱即用的 .NET 开发体验。
1、打开 VSCode,点击左侧活动栏的扩展图标(方块拼图形状)。
2、在搜索框中输入 C# Dev Kit,从搜索结果中选择由 Microsoft 发布的官方扩展。
3、点击“安装”按钮,安装完成后点击“重新加载”使扩展生效。
二、初始化 .NET 项目结构
借助 C# Dev Kit 内置的项目生成器,可快速创建符合现代 .NET 规范的解决方案,自动配置 launch.json、tasks.json 和 omnisharp.json,避免手动配置错误。
1、按下 Cmd+Shift+P(macOS)调出命令面板。
2、输入并选择 .NET: Create a new project。
3、依次选择项目类型(如 Console App)、框架版本(如 .NET 8.0)、语言(C#)、项目名称及保存路径。
4、确认后,C# Dev Kit 将自动执行 dotnet new 命令并生成完整项目文件夹结构。
三、配置跨平台调试环境
C# Dev Kit 自动识别项目中的 Program.cs 或启动类,并为当前工作区生成适配 macOS 的 launch.json 调试配置,支持断点、变量监视与异常捕获。
1、打开项目根目录下的 .vscode/launch.json 文件。
2、确认配置中 "type": "coreclr" 存在且 "project": "YourProject.csproj" 指向正确路径。
3、在 Program.cs 的任意可执行行左侧灰色区域单击,设置断点。
4、按 F5 启动调试,VSCode 将自动编译并附加到 dotnet 进程。
四、运行与管理单元测试
C# Dev Kit 集成 Test Explorer UI,可直接在侧边栏查看、筛选、运行 xUnit/NUnit/MSTest 测试用例,无需切换终端或手动执行 dotnet test。
1、在命令面板中执行 .NET: Create a new project,选择 xUnit Test Project 创建测试项目。
2、将测试项目添加至同一解决方案:右键解决方案根文件夹 → Add Existing Project → 选择 .csproj。
3、点击左侧活动栏的测试图标(试管形状),等待 Test Explorer 加载所有测试项。
4、点击单个测试名称旁的绿色三角形按钮,或点击顶部 Run All Tests 执行全部验证。
五、启用智能代码导航与重构
C# Dev Kit 深度集成 Roslyn 编译器平台,提供语义高亮、符号跳转、接口实现导航、安全重命名等高级语言功能,依赖本地 OmniSharp 服务但无需手动启动。
1、在任意 C# 文件中右键点击一个方法名,选择 Go to Implementation 查看其实现类。
2、将光标置于类名上,按下 Cmd+F12 查看所有继承者或实现者。
3、选中一个变量名,按下 F2 进入重命名模式,输入新名称后回车,所有引用将同步更新。
六、发布与打包应用
C# Dev Kit 提供一键发布向导,支持自包含部署(SCD)与框架依赖部署(FDD)两种模式,并自动生成 publish 目录结构,适配 macOS ARM64 架构。
1、在资源管理器中右键点击项目文件(.csproj),选择 .NET: Publish。
2、在发布向导中选择目标运行时:osx-arm64(Apple Silicon)或 osx-x64(Intel Mac)。
3、选择部署模式:Self-contained(含运行时)或 Framework-dependent(需目标机预装 .NET)。
4、点击“完成”,C# Dev Kit 调用 dotnet publish 并在 ./bin/publish/ 下生成可执行文件与依赖集。










