必须安装.NET SDK而非Runtime，且PATH需包含dotnet路径；验证标准是任意路径下dotnet --list-sdks输出含版本及路径，如8.0.400 [C:\Program Files\dotnet\sdk]。
VSCode + .NET SDK 是当前最轻量、最可控的 C# 开发组合，但装错组件或路径不生效，dotnet 命令就根本跑不起来——不是 VSCode 问题，而是环境没真正就位。
dotnet 命令报“不是内部或外部命令”？先查 PATH 和安装类型
这个错误 90% 不是 VSCode 配置问题，而是系统压根找不到 dotnet.exe。别急着重装插件，先做三件事：
- 打开全新 PowerShell（不是旧窗口），执行
where.exe dotnet；如果无输出，说明 PATH 没生效或根本没装对 - 确认你下载安装的是
.NET SDK（如dotnet-sdk-8.0.400-win-x64.exe），不是ASP.NET Core Runtime或.NET Runtime——后者不能执行dotnet new或dotnet build - Windows 安装器里必须勾选“将 .NET SDK 添加到 PATH”，且安装后要关掉所有终端再重开
验证成功的唯一标准：在任意路径下运行 dotnet --list-sdks，输出中必须包含类似 8.0.400 [C:\Program Files\dotnet\sdk] 的行。
C# 插件没反应？检查 OmniSharp 是否真启动了
装完 C# 扩展（ID：ms-dotnettools.csharp）后，右下角状态栏必须显示 OmniSharp: Ready，否则智能提示、跳转、错误检查全失效。常见卡点：
- 打开的是单个
.cs文件，而不是含.csproj的文件夹——VSCode 只在有项目文件的根目录才激活 C# 语言服务 - 第一次打开项目时卡在
OmniSharp: Starting…超过 2 分钟：国内网络常因下载omnisharp-win-x64.zip失败而卡住；可手动删掉%USERPROFILE%\.omnisharp\目录后重试 - 装了多个 SDK（比如 6.0、8.0、10.0），但项目
global.json指定了本地不存在的版本，OmniSharp 直接退出；删掉global.json或改用已安装的版本号
调试 F5 按下没反应？重点看 launch.json 的 program 字段
VSCode 默认生成的 .vscode/launch.json 中，program 字段必须指向编译后的 DLL，不是源码文件。错误写法："program": "${workspaceFolder}/Program.cs"；正确写法是：
"program": "${workspaceFolder}/bin/Debug/net8.0/MyApp.dll"这个路径依赖两个前提：
-
TargetFramework在.csproj中写的是net8.0（和你本地dotnet --list-sdks输出一致） - 项目已成功构建过一次（
dotnet build或首次F5会自动触发），否则bin/Debug/...目录还不存在 - VSCode 工作区必须打开的是项目根目录（含
.csproj的那层），不是上层父文件夹
为什么推荐 Code Runner 而不是直接 F5？
对于快速验证小逻辑（比如算法题、API 调用片段），Code Runner 插件配一个 dotnet run 命令比配置完整调试更直接。但它有个硬限制：只支持单文件执行，且要求当前文件能被 dotnet 识别为入口点（即含 public static void Main）。所以：
- 新建控制台项目后，
dotnet run在终端里执行最稳，Code Runner是锦上添花 - 不要指望它在没有
.csproj的纯.cs文件里自动还原 NuGet 包——它不处理项目依赖，只调dotnet run - 若需调试变量、断点、调用栈，必须走标准
F5+launch.json流程，Code Runner不提供调试器集成
真正的难点从来不在“怎么点下一步”，而在于 dotnet 是否真实可用、项目结构是否被正确识别、以及 OmniSharp 是否完成了初始化——这三个环节任何一处断掉，后续所有功能都会静默失效。
