Windows VS Code
作業實戰

VS Code 不是 compiler：三樣東西缺一不可

若 where.exe 列出多筆，先記下你要使用的第一筆。若你是照 00B 路線 0 讓 kernel 自動安裝的，g++ 與 gdb 會在 %LOCALAPPDATA%\jupyter-cpp-kernel\mingw64\bin，新開的終端機用 where.exe g++ 就會看到它。後面的三份 JSON 必須指向同一個 bin 資料夾，不能讓 IntelliSense 用 A、編譯用 B、除錯又用 C。

解壓縮後，開啟「整個資料夾」

在 VS Code 選「檔案 → 開啟資料夾」，選到能同時看到主程式、標頭檔、其他來源檔與測試資料的那一層。不要只在檔案總管雙擊一支 .cpp。

${workspaceFolder} 就是你開啟的這一層。之後把編譯輸出、執行時的 cwd 和資料檔位置都綁在這裡，換電腦後才不用重改一堆絕對路徑。

程式裡 include 標頭；命令列決定哪些 .cpp 要一起編譯

#include <iostream>    // std::cout
#include <vector>      // std::vector
#include <fstream>     // std::ifstream
#include <algorithm>   // std::sort
#include "MyClass.h"   // 自己的類別宣告

int main() {
    MyClass item;
    std::cout << item.value() << '\n';
}

先在終端機成功，再把同一條命令搬進 tasks.json

情境 A：只有一支主程式

情境 B：主程式 + 自己的實作檔

情境 C：程式要讀命令列參數與資料檔

情境 D：課程曾用過 Windows 圖形 linker

三份 JSON 各做一件事：路徑要一起換

在專案根目錄建立 .vscode 資料夾與下面三個檔案。範例使用 MSYS2 預設路徑；若你用 WinLibs，就把三處 C:/msys64/ucrt64/bin 一起換成實際含 g++.exe／gdb.exe 的資料夾，例如 C:/mingw64/bin。JSON 建議使用正斜線 /，可避免反斜線跳脫。 走 00B 路線 0 的電腦，三處路徑改成 ${env:LOCALAPPDATA}/jupyter-cpp-kernel/mingw64/bin/g++.exe（gdb 同一個資料夾），VS Code 會自動展開 ${env:…}。

1. tasks.json：真正送給 g++ 的編譯命令

{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "cppbuild",
      "label": "C/C++: build course program",
      "command": "C:/msys64/ucrt64/bin/g++.exe",
      "args": [
        "-fdiagnostics-color=always",
        "-std=c++17",
        "-Wall",
        "-Wextra",
        "-g",
        "-I.",
        "${workspaceFolder}/main.cpp",
        "${workspaceFolder}/MyClass.cpp",
        "-o",
        "${workspaceFolder}/main.exe"
      ],
      "options": {
        "cwd": "${workspaceFolder}"
      },
      "problemMatcher": ["$gcc"],
      "group": {
        "kind": "build",
        "isDefault": true
      }
    }
  ]
}

把 main.cpp、MyClass.cpp 換成本次真的要編譯的檔案；不需要的就刪掉。要加 -O2、-lgdi32 也加在 args，每個參數各占一個字串。

2. launch.json：F5 要執行哪支程式、帶什麼參數

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Debug course program",
      "type": "cppdbg",
      "request": "launch",
      "program": "${workspaceFolder}/main.exe",
      "args": ["input.txt", "--nogui"],
      "stopAtEntry": false,
      "cwd": "${workspaceFolder}",
      "environment": [],
      "externalConsole": false,
      "MIMode": "gdb",
      "miDebuggerPath": "C:/msys64/ucrt64/bin/gdb.exe",
      "setupCommands": [
        {
          "description": "Enable pretty-printing for gdb",
          "text": "-enable-pretty-printing",
          "ignoreFailures": true
        }
      ],
      "preLaunchTask": "C/C++: build course program"
    }
  ]
}

沒有命令列參數就把 args 改成空陣列 []。cwd 是程式尋找 input.txt 等相對路徑資料檔的起點；preLaunchTask 必須和 tasks.json 的 label 完全相同。

3. c_cpp_properties.json：IntelliSense 的 compiler 與標頭路徑

{
  "configurations": [
    {
      "name": "Windows GCC",
      "compilerPath": "C:/msys64/ucrt64/bin/g++.exe",
      "includePath": ["${workspaceFolder}/**"],
      "cStandard": "c17",
      "cppStandard": "c++17",
      "intelliSenseMode": "windows-gcc-x64"
    }
  ],
  "version": 4
}

先停在一行，再看變數怎麼變

1. 按 Ctrl + Shift + B，確認先能成功產生 main.exe。
2. 在想暫停的行號左邊點一下，出現紅點；快捷鍵是 F9。
3. 按 F5。VS Code 先執行 preLaunchTask 重新編譯，再交給 GDB。
4. 停住後看左側 Variables；想持續追蹤的運算式加到 Watch。
5. 用 F10 跑過目前這行、F11 進入函式；Call Stack 顯示函式是從哪裡呼叫進來的。

看到哪一句，就先查哪一層

七項都做到，才算環境完成

需要查細節時，回到官方文件

關鍵詞彙卡：點卡片翻面

這八個詞能講清楚，就不會再把「編輯器紅線」「compiler 錯誤」與「linker 錯誤」混成一件事。