VSCode需手动配置C++工具链：Windows用MSYS2装MinGW-w64（g++/gdb），设compilerPath和miDebuggerPath；Mac用Xcode自带clang++/lldb，禁用gdb；tasks.json须含-g、禁O2；launch.json按系统指定调试器。
VSCode 本身不是 IDE，它不自带 C++ 编译器或调试器，所以“搭建环境”的本质是：装好 clang 或 g++、配对的 lldb 或 gdb，再让 VSCode 通过 c_cpp_properties.json、tasks.json 和 launch.json 正确调用它们。Windows 和 Mac 的差异主要在工具链安装路径和默认调试器选择，不是配置逻辑本身。
Windows 下必须装 MinGW-w64（别碰 Visual Studio 的 MSVC 工具链）
VSCode 的 C/C++ 扩展对 MSVC 的 cl.exe 支持不稳定，尤其调试时容易卡在符号加载或路径解析。MinGW-w64 更轻量、兼容性更好，推荐用 MSYS2 安装：
- 运行
pacman -S mingw-w64-ucrt-x86_64-gcc mingw-w64-ucrt-x86_64-gdb mingw-w64-ucrt-x86_64-cmake - 把
C:\msys64\ucrt64\bin加进系统PATH（重启终端生效） - 验证：
g++ --version和gdb --version都应输出版本号 -
c_cpp_properties.json中"compilerPath"填"C:/msys64/ucrt64/bin/g++.exe"（注意正斜杠）
Mac 上优先用 clang++ + lldb（Xcode Command Line Tools 足够）
macOS 自带 clang 和 lldb，但需确认命令行工具已安装：
- 终端执行
xcode-select --install，按提示完成安装 - 检查：
clang++ --version应显示 Apple Clang；lldb --version应有输出 - 不要用 Homebrew 重装
gcc—— macOS 的clang对调试符号（DWARF）支持更完整，gdb在 Mac 上无法调试无签名二进制文件，基本不可用 -
c_cpp_properties.json中"compilerPath"设为"/usr/bin/clang++"
tasks.json 编译任务必须启用 -g 且禁用 -O2（否则断点失效）
调试依赖调试信息（DWARF），而优化会内联函数、删变量、重排指令，导致断点跳转错乱或变量显示为
立即学习“C++免费学习笔记（深入）”；
-
"args"列表里至少包含："-g"、"-std=c++17"（或你需要的版本）、"-Wall" - 绝对不要加
"-O2"或"-O3"；开发阶段用"-O0"（默认）最安全 - 如果用 CMake，确保
set(CMAKE_BUILD_TYPE Debug)，并在tasks.json中调用cmake --build . --config Debug - 编译后检查生成的可执行文件是否含调试段：
file ./a.out输出中应有with debug_info
launch.json 的 miDebuggerPath 容易填错（尤其 Windows）
VSCode 默认尝试用 gdb，但 Windows 下 MinGW-w64 的 gdb 可执行文件名是 gdb.exe，不是 gdb；Mac 下 lldb 不是靠 miDebuggerPath 指定，而是走 cppvsdbg 或 lldb 类型适配：
- Windows：
"miDebuggerPath"必须设为"C:/msys64/ucrt64/bin/gdb.exe"（路径+扩展名缺一不可） - Mac：用
"type": "lldb"，删掉"miDebuggerPath"字段；若留着会强制走 GDB 模式并报错 - 通用建议：在
"preLaunchTask"中指定你tasks.json里定义的构建任务名，确保每次调试前自动编译 - 启动失败常见错误：
Unable to start debugging. Exception: Error: connect ECONNREFUSED→ 检查gdb/lldb路径是否真实存在且可执行
真正卡住人的往往不是配置文件写法，而是工具链版本混用（比如用 Clang 编译却用 GDB 调试）、PATH 未生效、或者调试器权限被系统拦截（Mac 上首次运行 lldb 会弹窗要求允许辅助功能）。先跑通一个 cout 再加断点，比一上来就配多文件项目更可靠。
