vscode需安装官方c#扩展并配置正确.net sdk路径才能启用omnisharp智能补全；须卸载冲突插件、验证dotnet可用性、必要时手动指定omnisharp.dotnetpath并重启服务。
VSCode 默认不支持 C# 智能补全，必须手动启用 OmniSharp 服务；没装对扩展或没配好 .NET SDK 路径，OmniSharp 就会启动失败，补全、跳转、错误检查全失效。
装对扩展：只留 C#（Omnisharp）扩展，卸载其他 C# 相关插件
VSCode 市场里有多个名字带 “C#” 的扩展，但只有官方 Microsoft 维护的 C# 扩展（ID：ms-dotnettools.csharp）内置并管理 OmniSharp。其他如 “C# Extensions”、“OmniSharp” 独立版等，会和它冲突，导致 OmniSharp: Restart OmniSharp 命令无效或日志报 Failed to start OmniSharp server。
- 打开扩展面板（Ctrl+Shift+X），搜
C#，认准发布者是Microsoft - 禁用或卸载所有其他 C# / OmniSharp 名称的扩展
- 重启 VSCode，确保状态栏右下角出现
C#或OmniSharp图标
验证 .NET SDK 是否就位：终端跑 dotnet --list-sdks 必须有输出
OmniSharp 启动时依赖本地已安装的 .NET SDK（不是仅 .NET Runtime）。如果系统 PATH 里找不到 dotnet，或装的是 dotnet-host 这类精简包，OmniSharp 日志里会出现 Could not find dotnet executable 或直接卡在 “Starting OmniSharp server”。
- 终端执行
dotnet --list-sdks，至少应输出类似6.0.402 [/usr/share/dotnet/sdk] - Windows 用户若用 Scoop 安装，需确认
scoop bucket add extras后装的是scoop install dotnet-sdk，而非dotnet-host - macOS 使用 Homebrew 装完后，可能需运行
brew link --force dotnet-sdk确保dotnet在 PATH 中
必要时手动指定 omnisharp.path 或 omnisharp.dotnetPath
多数情况自动发现 SDK 就够用，但遇到跨平台路径解析异常（比如 WSL2 下 VSCode 运行在 Windows，却想用 Linux 侧的 SDK），或公司内网禁止自动下载 OmniSharp 服务器二进制时，就得手动干预。
- 打开设置（Ctrl+,），搜索
omnisharp.path，填入本地解压好的 OmniSharp 二进制路径（如/home/user/omnisharp/OmniSharp） - 更常用的是设
omnisharp.dotnetPath：指向你确认可用的dotnet可执行文件，例如/usr/local/share/dotnet/dotnet - 改完设置后务必执行命令面板（Ctrl+Shift+P）→
OmniSharp: Restart OmniSharp，别只靠重启编辑器
真正卡住的地方往往不是配置项本身，而是 dotnet 命令能否在 VSCode 内置终端里直接运行——因为 OmniSharp 启动时复用的是 VSCode 的环境变量。如果终端里 dotnet --version 正常，但 OmniSharp 日志仍报找不到，大概率是 VSCode 没读取到 shell 的完整 profile（尤其 macOS zsh / Linux bashrc 里 export 的 PATH）。这时候别调配置，先从终端启动 VSCode：code .，再开项目。
