VSCode 装完不能直接写 C#，关键不在编辑器本身。必须装对 .NET SDK，并让 VSCode 正确识别它。装错组件，比如只装 Runtime，或 PATH 没生效，或打开方式不对，dotnet 命令就跑不起来，后续功能也都会失效。

先排查最关键的几个问题：.NET SDK 是否装对、项目是否以正确方式打开、调试配置是否指向真实编译产物。这三个点没对齐，其他设置再全也没用。

先确认装的是 .NET SDK，不是 Runtime

这是最常见的问题。下载页面上的“ASP.NET Core Runtime”“Desktop Runtime”“.NET Runtime”，都只是运行已编译程序的环境。

它们不能编译 .cs 文件，不能生成项目，也不能支持调试。C# 开发唯一需要的是带“SDK”字样的安装包。

• dotnet-sdk-8.0.400-win-x64.exe（Windows）
• dotnet-sdk-8.0.400-osx-arm64.pkg（macOS）
• 通过包管理器安装的 dotnet-sdk-8.0（Linux）

安装后这样验证

验证命令必须全部成功。

• dotnet --version：输出版本号
• dotnet --list-sdks：输出类似 8.0.400 [C:Program Filesdotnetsdk] 的行

Windows 安装时，记得勾选“将 .NET SDK 添加到 PATH”。装完后，要关掉所有终端再重新打开。

macOS 用户如果用 brew install --cask dotnet-sdk，装完后务必补一句 xcode-select --install，否则 dotnet build 会报 MSB4236。

Linux 需要额外安装 libicu72 和 libssl3，否则 CoreCLR 初始化会直接失败。

VSCode 必须以文件夹方式打开含 .csproj 的项目

C# 扩展（OmniSharp 或 C# Dev Kit）只会在有项目定义文件的目录下激活语言服务。

如果只是打开单个 Program.cs 文件，状态栏会显示“C# features are disabled”，F5 也一定会失败。

正确打开方式

• 终端执行 dotnet new console -n MyApp
• 执行 cd MyApp
• 执行 code .
• 在 VSCode 中用 File > Open Folder 打开 MyApp 这一层

如果之前是按单个文件打开的，直接关掉整个 VSCode 窗口，再用文件夹方式重新打开。

右下角状态栏应显示 C# (.NET) 或 OmniSharp: Ready。

如果卡在“Starting…”超过 2 分钟，大概率是 OmniSharp 下载 omnisharp-win-x64.zip 失败。可以手动删掉 %USERPROFILE%.omnisharp 目录后重试。

launch.json 的 program 字段必须指向编译后的 DLL

F5 调试失败，最常见的原因，是 launch.json 里的 program 写成了源码路径。

比如 "${workspaceFolder}/Program.cs" 这种写法就是错的。VSCode 调试器只能附加到已编译的托管进程，不能直接附加源文件。

正确写法

"program": "${workspaceFolder}/bin/Debug/net8.0/MyApp.dll"

这个路径能成立，有几个前提条件：

• TargetFramework 在 .csproj 中设为 net8.0
• 它要与 dotnet --list-sdks 输出匹配
• 项目已经成功构建过一次，例如执行过 dotnet build，或首次 F5 已触发构建

如果项目用 global.json 锁定了 6.0.100，但本地只装了 8.0.400，OmniSharp 会直接退出。要么安装对应 SDK，要么删掉 global.json。

C# Dev Kit 下要关掉 OmniSharp 自动启用

新版 C# Dev Kit 默认仍会尝试启动 OmniSharp 进程。但它和 .NET 8+ 的 LSP（Language Server Protocol）模式会冲突。

冲突后常见表现包括：智能提示缺失、断点不命中、命名空间找不到。

处理方法

• 打开 VSCode 设置（Ctrl+,）
• 搜索 omnisharp.useGlobalMono，设为 never
• 再搜索 csharp.extension.autoStart，将其关闭

设置完成后，重启 VSCode。

正常情况下，右下角会出现 .NET 8.0.400 提示，状态栏显示 C# (LSP)，而不是 OmniSharp。

如果仍然异常，按 Ctrl+Shift+P，输入 C#: Select .NET SDK，然后手动指定 SDK 路径，例如 C:Program Filesdotnet。

最后只看这三个关键点

• .NET SDK 是否真正安装到位
• 项目是否以正确层级、正确文件夹方式打开
• launch.json 是否指向真实存在的编译产物

这三个点才是 VSCode 写 C# 能否正常工作的决定因素。如果这几项没对齐，其他配置基本都不会生效。