VSCode与.NET/C#开发：C# Dev Kit完全指南_网络技术

发布时间 - 2025-12-30 00:00:00 点击率：次

C# Dev Kit 配置流程包括：一、安装扩展并重启；二、验证并指定 .NET SDK 路径；三、启用自动项目配置；四、重启 OmniSharp 或清理缓存修复 IntelliSense；五、通过 .csdevkit.json 声明目标框架并重载项目系统。

如果您在使用 Visual Studio Code 进行 C# 开发时发现缺少智能感知、调试支持或项目加载异常，很可能是未正确安装或配置 C# Dev Kit 扩展。以下是针对该扩展的完整配置与问题应对流程：

本文运行环境：MacBook Pro，macOS Sequoia。

一、安装 C# Dev Kit 扩展

C# Dev Kit 是微软官方为 VS Code 提供的集成开发体验增强包，它整合了 OmniSharp、.NET SDK 检测、调试器配置与项目模板支持，替代了旧版 C# 扩展的部分功能。

1、启动 VS Code，点击左侧活动栏中的扩展图标（方块拼图形状）。

2、在扩展市场搜索框中输入 C# Dev Kit，确认发布者为 Microsoft。

3、点击“安装”按钮，等待下载完成并自动启用。

4、安装完成后，VS Code 可能提示重启窗口，点击“立即重启”以加载新功能。

C# Dev Kit 依赖本地已安装的 .NET SDK 才能提供语言服务与构建能力；若 SDK 缺失或路径未被识别，将导致项目无法加载或出现红色波浪线。

1、打开终端，执行命令 dotnet --list-sdks，确认输出至少包含一个 6.0 或更高版本的 SDK 路径。

2、若命令报错或无输出，需前往 https://dotnet.microsoft.com/download 下载并安装最新 .NET SDK。

3、安装完毕后，在 VS Code 中按下 Cmd+Shift+P（Mac）调出命令面板，输入并选择 C#：Select .NET SDK，手动指定 SDK 安装路径。

该功能可自动检测解决方案文件（.sln）、项目文件（.csproj）并初始化调试环境与 OmniSharp 后端，避免手动配置 launch.json 或 tasks.json。

1、在 VS Code 中打开包含 .sln 或 .csproj 的文件夹。

2、首次打开时，右下角会弹出通知 C# Dev Kit detected a .NET project. Would you like to enable full support?，点击“Enable”。

3、状态栏右侧将显示 C# (Dev Kit) 图标，且项目结构视图中出现“C# Projects”侧边栏节点。

当代码补全、跳转定义或错误检查未响应时，可能因 OmniSharp 进程崩溃、缓存损坏或工作区配置冲突导致。

1、按下 Cmd+Shift+P，输入并选择 C#：Restart OmniSharp。

2、若无效，进入命令面板执行 Developer: Toggle Developer Tools，在控制台中查看 OmniSharp 启动日志是否有 Failed to load project 类错误。

3、关闭当前工作区，在终端中执行 rm -rf .vscode/omnisharp/ 删除缓存目录，重新打开文件夹。

C# Dev Kit 默认支持 net6.0 和 net8.0，但若项目使用 net48、net5.0 或自定义 TFM，需显式声明运行时兼容性。

1、在项目根目录创建或编辑 .csdevkit.json 文件。

2、写入以下内容，替换其中的 TFM 值为实际目标框架：{"targetFrameworks": ["net6.0", "net8.0"]}。

3、保存后，按下 Cmd+Shift+P 并运行 C#：Reload Project System 使配置生效。