Visual Studio Code 如何 Debug调试 CPP项目

本文由 ChatGPT 生成

Here’s a clean, practical way to set up C/C++ debugging in VS Code on Windows (since you’re using cl.exe and MSVC).

---

🧰 1. Install required tools

✅ Install:

• Visual Studio Code
• C/C++ Extension (Microsoft)
• MSVC toolchain from Visual Studio 2022 (you already have it ✔)

---

⚙️ 2. Make sure MSVC environment is loaded

cl.exe only works inside the Developer Command Prompt.

👉 Either:

• Launch VS Code from:

  x64 Native Tools Command Prompt for VS 2022
  code .
  

OR

• Use vcvars64.bat inside tasks (more advanced)

---

🏗️ 3. Create build task (tasks.json)

Press:

Ctrl + Shift + P → "Tasks: Configure Task"

Example:

{"version": "2.0.0","tasks": [{"label": "build with cl","type": "shell","command": "cl","args": ["/Zi","/MDd","/Od","main.cpp","/Fe:main.exe"],"group": {"kind": "build","isDefault": true},"problemMatcher": ["$msCompile"]}]
}

🔑 Important flags:

• /Zi → debug symbols
• /Od → disable optimization
• /MDd → match your Box2D build

---

🐞 4. Create debug config (launch.json)

Press:

F5 → "C++ (Windows)"

Then edit:

{"version": "0.2.0","configurations": [{"name": "Debug (MSVC)","type": "cppvsdbg","request": "launch","program": "${workspaceFolder}/main.exe","args": [],"cwd": "${workspaceFolder}","preLaunchTask": "build with cl","stopAtEntry": false}]
}

---

▶️ 5. Run debugger

Press:

F5

You can now:

• set breakpoints
• step (F10, F11)
• inspect variables

---

🔍 Common issues (very relevant to you)

❗ Breakpoints not hit

➡ You forgot /Zi

---

❗ Symbols not loaded

➡ Make sure .pdb file is generated

---

❗ Box2D debugging doesn't work

➡ You need to build Box2D with debug symbols too:

cmake -DCMAKE_BUILD_TYPE=Debug

---

❗ cl.exe not found

➡ You didn’t launch from Developer Command Prompt

---

🧠 Bonus: If using your custom build system (SelfMake)

Instead of cl directly:

• Make tasks.json call your build tool
• Keep /Zi /MDd /Od in your compile flags

---

👍 Minimal working mental model

• tasks.json → how to build
• launch.json → how to run/debug
• /Zi → enables debugging
• /MDd → must match all libs (your earlier issue!)

---

If you want, I can:

• adapt this to your Box2D project
• or wire it into your SelfMake build system so debugging works seamlessly