VSCode for .NET Core：C#开发环境搭建全程指南

VSCode 搭建 .NET Core C# 开发环境只需三步：安装官方 .NET SDK（非 Runtime）、配置 C#、.NET Install Tool 和 XML 注释三个核心插件、用 dotnet new 创建并调试控制台项目；默认配置即可运行，无需手动修改 settings.json 或 launch.json。

VSCode 搭建 .NET Core C# 开发环境并不难，关键在装对工具、配好路径、验证到位。跳过冗余步骤，直接聚焦核心环节。

安装 .NET SDK（不是 Runtime）

VSCode 本身不带 .NET 运行时，必须单独安装官方 SDK。去 https://dotnet.microsoft.com/download 下载最新 LTS 版本（如 .NET 8.0），选对应系统（Windows/macOS/Linux）的 Installer。安装完后打开终端执行：

看到版本号（如 8.0.302）说明 SDK 安装成功。注意：别只装 Runtime，它不能编译代码；也别用 Visual Studio 自带的 SDK，VSCode 默认不识别其路径。

配置 VSCode 核心插件

仅需三个插件即可覆盖日常开发：

• C# for Visual Studio Code（由 OmniSharp 提供，支持智能提示、调试、重构）
• .NET Install Tool for Extension Authors（自动检测并安装所需 .NET 工具链，新手友好）
• C# XML Documentation Comments（写 /// 注释时自动生成 XML 模板，可选但推荐）

安装后重启 VSCode，首次打开 C# 文件时，OmniSharp 会自动启动并下载适配当前 .NET 版本的语言服务器——这个过程可能需要几十秒，请耐心等待右下角状态栏出现 OmniSharp: Ready。

创建并运行第一个控制台项目

不用新建文件夹再手动写 csproj——终端里一条命令搞定：

NameGPT

免费的名称生成器，AI驱动在线生成企业名称及Logo

119

查看详情

VSCode 打开文件夹后，按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 .NET: Run Project 回车，就能直接运行。也可按 F5 启动调试，默认会读取 launch.json 配置（首次调试时 VSCode 会引导生成）。

如果遇到“无法找到调试器”提示，检查是否已启用 C# 插件，并确认项目根目录下有 bin/ 和 obj/ 文件夹（说明 build 成功）。

调试与常见问题速查

调试是高频操作，几个关键点要盯住：

• 断点必须打在可执行行上（比如方法体内，不能打在 using 或 namespace 行）
• 确保 Program.cs 是入口文件，且包含 main 方法（.NET 6+ 支持顶层语句，但调试仍依赖隐式入口）
• 若调试启动失败，查看 VSCode 的 Debug Console 输出，常见原因是 dotnet 命令未加入系统 PATH（重装 SDK 并勾选“将 dotnet 添加到 PATH”可解决）
• 修改代码后无需手动 rebuild，F5 调试时 VSCode 会自动触发 dotnet build

基本上就这些。不需要改 settings.json，也不用配 launch.json 到很细——默认配置已足够起步。真正复杂的项目（如 ASP.NET Core Web API）再逐步加扩展（比如 REST Client、ESLint for C# 等）。

以上就是VSCode for .NET Core：C#开发环境搭建全程指南的详细内容，更多请关注php中文网其它相关文章！