VS Code 配置 C++ 项目编译与调试指南（MSVC/GCC）

2. 配置 tasks.json（编译任务）

作用：定义编译规则，指定 .obj/.exe 输出路径、链接 .lib 库，自动创建输出目录。

{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "cppbuild",
      "label": "MSVC: 编译 C++ 项目",
      "command": "cl.exe",
      "args": [
        "/Zi",
        "/EHsc",
        "/Od",
        "/Fo:${workspaceFolder}/build/obj/",
        "/Fe:${workspaceFolder}/build/bin/output.exe",
        "${workspaceFolder}/src/*.cpp",
        "/LIBPATH:${workspaceFolder}/lib",
        "mylib.lib"
      ],
      "options": {
        "cwd": "${workspaceFolder}",
        "shell": {
          "executable": "cmd.exe",
          "args": ["/c", "if not exist build\\obj md build\\obj && if not exist build\\bin md build\\bin"]
        }
      },
      "problemMatcher": ["$msvc"],
      "group": {
        "kind": "build",
        "isDefault": true
      },
      "detail": "MSVC 编译：输出到 build/obj（.obj）和 build/bin（.exe）"
    },
    {
      "label": "MSVC: 清理文件",
      "command": "del",
      "args": [
        "${workspaceFolder}/build/obj/*.obj",
        "${workspaceFolder}/build/bin/*.exe",
        "${workspaceFolder}/build/bin/*.pdb"
      ],
      "type": "shell",
      "problemMatcher": []
    }
  ]
}

3. 配置 launch.json（调试配置）

作用：关联编译产物，启动调试器（MSVC 用 cppvsdbg），支持断点、变量监控。

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "MSVC: 调试 C++ 项目",
      "type": "cppvsdbg",
      "request": "launch",
      "program": "${workspaceFolder}/build/bin/output.exe",
      "args": [],
      "stopAtEntry": false,
      "cwd": "${workspaceFolder}",
      "environment": [],
      "externalConsole": true,
      "preLaunchTask": "MSVC: 编译 C++ 项目"
    }
  ]
}

场景 2：GCC/MinGW 编译器（Windows/Linux/macOS）

1. 配置 c_cpp_properties.json（智能提示）

{
  "configurations": [
    {
      "name": "windows-gcc-x64",
      "includePath": [
        "${workspaceFolder}/**",
        "${workspaceFolder}/include",
        "C:/MinGW/lib/gcc/x86_64-w64-mingw32/8.1.0/include"
      ],
      "compilerPath": "C:/MinGW/bin/g++.exe",
      "cStandard": "gnu17",
      "cppStandard": "gnu++17",
      "intelliSenseMode": "gcc-x64",
      "browse": {
        "path": ["${workspaceFolder}/**"],
        "limitSymbolsToIncludedHeaders": true
      }
    }
  ],
  "version": 4
}

2. 配置 tasks.json（编译任务）

{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "cppbuild",
      "label": "GCC: 编译 C++ 项目",
      "command": "g++.exe",
      "args": [
        "-g",
        "-Wall",
        "-std=c++17",
        "-c",
        "${workspaceFolder}/src/*.cpp",
        "-I${workspaceFolder}/include",
        "-o",
        "${workspaceFolder}/build/obj/${fileBasenameNoExtension}.o",
        "&&",
        "g++.exe",
        "${workspaceFolder}/build/obj/*.o",
        "-o",
        "${workspaceFolder}/build/bin/output.exe",
        "-L${workspaceFolder}/lib",
        "-lmylib"
      ],
      "options": {
        "cwd": "${workspaceFolder}",
        "shell": {
          "executable": "cmd.exe",
          "args": ["/c", "mkdir -p build\\obj build\\bin 2>nul"]
        }
      },
      "problemMatcher": ["$gcc"],
      "group": {
        "kind": "build",
        "isDefault": true
      },
      "detail": "GCC 编译：输出到 build/obj（.o）和 build/bin（.exe）"
    },
    {
      "label": "GCC: 清理文件",
      "command": "rm",
      "args": [
        "${workspaceFolder}/build/obj/*.o",
        "${workspaceFolder}/build/bin/output.exe"
      ],
      "type": "shell",
      "problemMatcher": []
    }
  ]
}

3. 配置 launch.json（调试配置）

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "GCC: 调试 C++ 项目",
      "type": "cppdbg",
      "request": "launch",
      "program": "${workspaceFolder}/build/bin/output.exe",
      "args": [],
      "stopAtEntry": false,
      "cwd": "${workspaceFolder}",
      "environment": [],
      "externalConsole": true,
      "MIMode": "gdb",
      "setupCommands": [
        {
          "description": "启用 GDB 整齐打印",
          "text": "-enable-pretty-printing",
          "ignoreFailures": true
        }
      ],
      "preLaunchTask": "GCC: 编译 C++ 项目",
      "miDebuggerPath": "gdb.exe"
    }
  ]
}

核心操作步骤

1. 创建配置文件：
   • c_cpp_properties.json：Ctrl+Shift+P → C/C++: Edit Configurations (JSON)。
   • tasks.json：Ctrl+Shift+P → Tasks: Configure Task → 选择对应编译器。
   • launch.json：调试面板 → 创建 launch.json 文件 → 选择对应编译器。
2. 编译：Ctrl+Shift+B 执行默认编译任务，生成 .obj/.o 和 .exe。
3. 调试：F5 启动调试，支持断点（行号左侧点击）、单步执行（F10/F11）、变量监控。

常见问题解决

1. 编译器找不到（如 cl.exe/g++.exe 不是内部命令）

• MSVC：必须通过「x64 原生工具命令提示」启动 VS Code，或手动指定 compilerPath 绝对路径。
• GCC/MinGW：检查环境变量是否添加编译器路径，重启 VS Code。

2. 断点灰色（无法命中）

• 编译参数缺少调试信息：MSVC 需加 /Zi，GCC 需加 -g。
• launch.json 的 program 路径与 tasks.json 的 exe 路径不一致。

3. 中文乱码

• MSVC：在 tasks.json 的 args 中添加 /source-charset:utf-8。
• GCC/MinGW：在 tasks.json 的 args 中添加 -fexec-charset=GBK（Windows）/ -fexec-charset=UTF-8（Linux/macOS）。

4. 链接库报错（undefined reference to...）

• 确认库路径（/LIBPATH/-L）和库名（mylib.lib/-lmylib）拼写正确。
• MSVC 库为 .lib，GCC 需用 MinGW 编译的 .a 库（MSVC 编译的 .lib 不兼容）。

总结

核心原则：

1. 三个配置文件的路径必须一致（如 build/bin/output.exe）；
2. 编译器环境需提前加载（MSVC 用工具命令提示，GCC 配环境变量）；
3. 调试信息参数（/Zi/-g）必须加，否则无法调试。