VS Code 配置 C/C++ 开发环境指南（支持万能头文件）

VS Code 配置 C/C++ 开发环境指南

本文介绍如何在 VS Code 中配置 C/C++ 开发环境，实现轻量化配置并支持万能头文件 bits/stdc++.h。方案将确保所有 exe 文件统一输出到 bin 文件夹，cpp 文件统一存放到 src 文件夹。

一、环境准备

1. VS Code 安装

访问 VS Code 官网 下载并安装。建议不要安装在 C 盘，若更改路径，请确保路径中不包含中文和空格。其他选项默认即可。

如需中文界面，可在扩展商店搜索并安装中文语言包，重启 VS Code 生效。

2. MinGW 安装

VS Code 本身是文本编辑器，需安装编译器。推荐使用 WinLibs 获取轻量化的 MinGW-w64 + GCC。

2.1 获取与解压

访问 WinLibs 官网，下载最新版压缩包。解压至指定路径（路径中不要有空格和中文），记住该路径。

复制 mingw64/bin 文件夹的路径，后续配置将频繁使用。

2.2 编辑环境变量

在 Windows 系统中打开环境变量设置：

• Win11：点击开始菜单搜索'环境变量'并打开。
• Win10：按 Win+R，输入 sysdm.cpl 后确定。

进入系统属性窗口，点击'高级'选项卡下的'环境变量'。在'系统变量'中找到 Path，双击编辑。

将之前复制的 mingw64/bin 路径添加到列表中，保存并应用。

验证安装：打开终端（cmd），输入 g++ --version 和 gcc --version，若能显示版本信息则配置成功。

3. 安装扩展

进入 VS Code 扩展市场，搜索并安装 C/C++ 扩展，安装后重启 VS Code。

二、配置 CPP

1. 目录结构

建议在存放代码的文件夹上级创建一个根目录以便管理。

1. 创建代码总文件夹（可选）。
2. 在根目录下创建 src 文件夹用于存放 .cpp 源文件。
3. 在根目录下创建 bin 文件夹用于存放编译后的可执行文件。

注意：确保文件扩展名可见，以便正确识别 .cpp 文件。

2. .vscode 配置

在项目根目录下创建 .vscode 文件夹，并在其中创建以下配置文件。请务必将示例中的路径修改为实际路径。

2.1 c_cpp_properties.json

此文件由 C/C++ 扩展读取，用于提供 IntelliSense 信息（如编译器路径、标准、头文件搜索路径）。

{
    "version": 4,
    "configurations": [
        {
            "name": "WinLibs-GCC",
            "compilerPath": "<你的 g++.exe 路径>",
            "cStandard": "c17",
            "cppStandard": "c++20",
            "intelliSenseMode": "windows-gcc-x64",
            "includePath": [
                "${workspaceFolder}/src/**",
                "${workspaceFolder}/**"
            ],
            "defines": []
        }
    ]
}

2.2 tasks.json

定义构建任务，控制如何编译当前活动文件。

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Build Active File (WinLibs)",
            "type": "shell",
            "command": "g++",
            "args": [
                "-std=c++20",
                "-g3",
                "-ggdb",
                "-O0",
                "-Wall",
                "-Wextra",
                "-Wshadow",
                "-DLOCAL",
                "${file}",
                "-o", "${workspaceFolder}/bin/${fileBasenameNoExtension}.exe"
            ],
            "options": {
                "env": {
                    "PATH": "${env:PATH};<你的 mingw64\bin 路径>"
                }
            },
            "group": {
                "kind": "build",
                "isDefault": true
            },
            "problemMatcher": ["$gcc"]
        }
    ]
}

注：若编译器版本过低，可将 -std=c++20 调整为 c++17 或 c++14。

2.3 launch.json

定义调试配置，指定调试器类型及启动参数。

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Debug Active File (gdb)",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/bin/${fileBasenameNoExtension}.exe",
            "args": [],
            "cwd": "${workspaceFolder}",
            "environment": [
                {
                    "name": "PATH",
                    "value": "${env:PATH};<你的 mingw64\bin 路径>"
                }
            ],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "<你的 gdb.exe 路径>",
            "preLaunchTask": "Build Active File (WinLibs)"
        }
    ]
}

3. 测试运行

1. 右键 src 文件夹，新建 .cpp 文件。
2. 编写简单代码，例如 #include <bits/stdc++.h> 并使用 main 函数。
3. 点击运行按钮或使用快捷键 F5 进行调试。
4. 确认断点设置正常，程序能顺利输出结果。

完成上述步骤后，即可在 VS Code 中高效地进行 C/C++ 开发与调试。