Windows 下 VS Code 配置 C/C++ 編譯調試完整指南

Visual Studio Code（VS Code）憑藉輕量級、跨平台、擴展豐富的特性，已成為 C/C++ 開發的主流選擇之一。本文詳細記錄在 Windows 環境下，基於 MinGW-w64 工具鏈，配置 VS Code 實現 C/C++ 編譯、運行與斷點調試、變量監視、調用堆棧查看、條件斷點等完整開發體驗的全過程。

一、效果預覽

配置完成後即可享受 IDE 級調試體驗：

• 斷點調試、變量監視、調用堆棧
• 條件斷點 支持複雜調試場景

二、整體流程概覽

1. 下載安裝 VS Code
2. 安裝 C/C++ 擴展
3. 安裝 MinGW-w64 編譯調試工具鏈
4. 配置系統環境變量 PATH
5. 修改 VS Code 調試配置文件 launch.json 與任務配置 tasks.json
6. 驗證調試效果

三、詳細配置步驟

3.1 下載安裝 VS Code

• 官網：https://code.visualstudio.com/Download
• 推荐下載 User Installer 或 ZIP 綠色版（解壓即用）

3.2 安裝 C/C++ 擴展

1. 打開 VS Code，按 Ctrl+Shift+X 進入擴展面板
2. 搜索 C/C++（微軟官方發布，發布者 Microsoft）
3. 點擊安裝，安裝過程可能較慢（需下載語言服務），請耐心等待
4. 安裝完成後按提示重啟 VS Code

3.3 安裝 MinGW-w64（推薦）

注意：原文使用舊版 MinGW（mingw.org），已停止維護。強烈建議使用 MinGW-w64（支持 64 位、C++17/20、更完善的 gdb）。

1. 下載地址：MinGW-w64 Releases 或 WinLibs（預構建、無需安裝器）
2. 選擇 x86_64-posix-seh 版本（64位、POSIX 線程模型、SEH 異常處理）
3. 解壓至無中文、無空格路徑，例如 D:\mingw64
4. 關鍵步驟：將 D:\mingw64\bin 加入系統環境變量 Path

驗證安裝：重啟終端（CMD/PowerShell），輸入 g++ --version、gdb --version 均顯示版本號即成功。

3.4 VS Code 調試配置

前置條件：VS Code 必須以資料夾形式打開項目（Ctrl+K Ctrl+O），單文件模式無法生成調試配置。

1. 新建 test.cpp 編寫測試代碼
2. 按 F5 → 選擇 C++ (GDB/LLDB) → 選擇 g++ build and debug active file
3. VS Code 將在 .vscode 目錄下生成 launch.json 與 tasks.json

3.4.1 替換 launch.json

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "C++ Debug (GDB)",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}\\${fileBasenameNoExtension}.exe",
            "miDebuggerPath": "D:\\mingw64\\bin\\gdb.exe",  // ★修改為你的 gdb 實際路徑
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": true,
            "preLaunchTask": "C++ Build",
            "setupCommands": [
                {
                    "description": "啟用美化打印",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ]
        }
    ]
}

3.4.2 替換 tasks.json

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "C++ Build",
            "type": "shell",
            "command": "g++",
            "args": [
                "-g",                      // 生成調試符號
                "-std=c++17",              // C++ 標準，可改為 c++20
                "-Wall",                   // 開啟常見警告
                "-fexec-charset=GBK",      // 解決 Windows 控制台中文亂碼
                "${file}",
                "-o",
                "${fileDirname}\\${fileBasenameNoExtension}.exe"
            ],
            "problemMatcher": {
                "owner": "cpp",
                "fileLocation": ["relative", "${workspaceFolder}"],
                "pattern": {
                    "regexp": "^(.*):(\\d+):(\\d+):\\s+(warning|error):\\s+(.*)$",
                    "file": 1, "line": 2, "column": 3, "severity": 4, "message": 5
                }
            },
            "group": { "kind": "build", "isDefault": true },
            "detail": "編譯當前文件並生成調試可執行文件"
        }
    ]
}

3.5 開始調試

1. 在 test.cpp 設置斷點（行號左側點擊）
2. 按 F5 啟動調試
3. 觀察 變量面板、監視面板、調用堆棧、斷點面板
4. 使用 F10（步過）、F11（步入）、Shift+F11（步出）、F5（繼續）
5. 右鍵斷點可設置 條件斷點、命中計數、日誌點

四、常見問題排查

五、進階建議

• CMake + CMake Tools 擴展：大型項目標準化構建，自動生成 launch.json
• Clangd 擴展：比官方 C/C++ 擴展更快、更準的語義分析、補全、重構
• Code Runner：快速運行單文件（不調試）
• Remote - SSH / WSL：跨平台一致開發體驗

六、總結

通過「VS Code + MinGW-w64 + C/C++ 擴展」組合，在 Windows 上即可獲得輕量且強大的 C/C++ 開發調試環境。關鍵點在於：正確安裝工具鏈、配置環境變量、編寫規範的 launch.json 與 tasks.json。掌握此流程後，可輕鬆遷移至 Linux/macOS 或容器化開發環境。