2025 VSCode中如何进行dotnet开发环境配置完整教程

我一直都是用Visual Studio 2019来开发C#项目的，用的比较顺手，也习惯了。看其他技术文章有介绍VS Code更轻量，更方便。

所以就想来研究如何使用VS Code，看看它是如何构建代码、调试代码、如何运行C#应用程序。

本文将详细介绍如何在VS Code中配置.NET开发环境，演示环境为Windows系统。

一、环境准备

1. 安装.NET SDK

访问.NET官网
下载并安装最新的.NET SDK（推荐.NET6/8，因为是长期支持版本，LTS版本）
验证安装：

shell 复制代码

dotnet --version

可以用list指令查看安装的所有版本

shell 复制代码

dotnet --list-sdks

2. 安装Visual Studio Code

访问VSCode官网
下载安装最新稳定版，没什么好说的

二、必要扩展安装

打开VSCode扩展市场（Ctrl+Shift+X）
搜索并安装以下扩展：
- C# (由Microsoft提供)
- NuGet Package Manager
- C# Extensions

三、项目配置

1. 创建新项目

shell 复制代码

dotnet new console -n demo01
cd demo01
code .

其中

dotnet new是新建项目，console就是控制台类型的项目，有以下项目类型：

code .是打开VSCode的命令行

dotnet命令行对应的编译和运行指令：

shell 复制代码

dotnet new console -n demo01    #新建demo01项目
dotnet build                    #编译demo01项目
dotnet run                      #运行demo01项目

本篇我们想看的是VSCode开发环境的搭建，所以我们继续看VSCode下如何编译调试，主要是要配置launch.json和tasks.json

2. 项目结构说明

复制代码

demo01/
├── Program.cs        # 主程序文件
├── demo01.csproj     # 项目配置文件
└── obj/              # 编译生成目录

3. 调试配置

按主侧边栏的三角形调试按钮，创建launch.json和tasks.json
选择"C#"环境
示例配置：

launch.json:

json 复制代码

{
    // 使用 IntelliSense 了解相关属性。 
    // 悬停以查看现有属性的描述。
    // 欲了解更多信息，请访问: https://go.microsoft.com/fwlink/?linkid=830387
    "version": "0.2.0",
    "configurations": [
        {
            "name": ".NET Core Launch (console)",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build",
            "program": "${workspaceFolder}/bin/Debug/net8.0/demo01.exe",
            "args": [],
            "cwd": "${workspaceFolder}",
            "stopAtEntry": false,
            "console": "internalConsole"
        }

    ]
}

tasks.json:

json 复制代码

{
    // See https://go.microsoft.com/fwlink/?LinkId=733558
    // for the documentation about the tasks.json format
    "version": "2.0.0",
    "tasks": [
        {
            "label": "build",
            "command": "dotnet",
            "type": "shell",
            "args": [
                "build",
                // Ask dotnet build to generate full paths for file names.
                "/property:GenerateFullPaths=true",
                // Do not generate summary otherwise it leads to duplicate errors in Problems panel
                "/consoleloggerparameters:NoSummary"
            ],
            "group": "build",
            "presentation": {
                "reveal": "silent"
            },
            "problemMatcher": "$msCompile"
        }
    ]
}

这样就能调试起来了，F5,F10,F11快捷键和VS2019的都一样，查看临时变量，监视内存这些基本调试功能都有。

这里补充说明下：

在VSCode 中，tasks.json 和 launch.json 是两个重要的配置文件：

tasks.json - 任务配置

作用：

√ 定义项目特定的构建/开发任务

典型用途：

√ 配置项目构建命令（如 dotnet build）

√ 设置代码格式化/linting任务

√ 自动化测试执行

√ 文件清理等维护任务

示例配置可能包含：

• C# 项目编译命令

• 单元测试运行配置

• 代码质量检查任务

launch.json - 调试配置

作用：

√ 定义调试会话的启动参数

核心功能：

√ 配置调试器启动参数

√ 设置环境变量

√ 指定可执行文件路径

√ 控制调试会话行为

典型 C# 配置可能包含：

• .NET Core 启动配置

• 调试目标程序集指定

• 启动参数设置