macos上直接用系统自带clang即可，无需安装gcc或自编译llvm；确认clang --version≥13，若未安装则运行xcode-select --install；includepath须用clang -v -e -x c++ - &1 | grep "^\s*#include"获取并配置；tasks.json中command必须为/usr/bin/clang，args含"-g"、"${file}"等；launch.json的program路径需与tasks输出一致。
macOS 上直接用系统自带的 clang 就够了，别装 gcc 或自己编译 LLVM——除非你明确要 C++26 模块或跨平台交叉编译，否则纯属引入路径冲突和 IntelliSense 失效。
确认 clang 是否可用且版本够新
VS Code 不自带编译器，它只调用系统命令。先在终端跑这句：
clang --version
输出里版本号 ≥ 13（macOS Ventura 及之后默认带 14+）就满足 C++17/C++20 开发；若报 command not found，执行：
xcode-select --install
等安装完成再试。不用装完整 Xcode，命令行工具包（Command Line Tools）足矣。别用 brew install llvm 覆盖系统路径——/usr/bin/clang 是 Apple 官方签名、与 SDK 深度绑定的版本，IntelliSense 和调试器都依赖它。
c_cpp_properties.json 的 includePath 别手填
标红 #include <stdio.h></stdio.h>、跳转失效、补全不工作？90% 是 includePath 没对。手动写 /Applications/Xcode.app/... 很容易错（比如没装 Xcode 但写了它的路径），正确做法是让 clang 自己吐出来：
clang -v -E -x c++ - &1 | grep "^\s*#include"
输出类似：
#include "" search starts here: /Library/Developer/CommandLineTools/usr/include/c++/v1 /usr/include /System/Library/Frameworks (framework directory) End of search list.
把上面两行路径复制进 c_cpp_properties.json 的 includePath 字段，逗号分隔，注意加 ${workspaceFolder} 在最前：
"includePath": [
"${workspaceFolder}",
"/Library/Developer/CommandLineTools/usr/include/c++/v1",
"/usr/include"
]
配置入口：Cmd+Shift+P → C/C++: Edit Configurations (UI) → “Include path” 栏粘贴。
tasks.json 的 command 必须是 /usr/bin/clang
按 Cmd+Option+B 编译失败却没报错？大概率 tasks.json 里 command 写成了 gcc 或空字符串。macOS 的 /usr/bin/gcc 实际是 clang 的符号链接，但 VS Code 的 C/C++ 扩展会因路径名误判为 GCC，导致 IntelliSense 配置错乱。
确保 tasks.json 中：
-
command固定为/usr/bin/clang -
args至少含："-g"（调试信息）、"${file}"（源文件）、"-o"、"${fileDirname}/${fileBasenameNoExtension}"（输出可执行名） - 如果代码含
scanf或需要终端交互，加"-fansi-escape-codes"，否则输入可能卡住或颜色异常 - 别用
"${fileDirname}/a.out"——多个 .c 文件会互相覆盖
示例片段：
{
"version": "2.0.0",
"tasks": [{
"type": "shell",
"label": "clang build active file",
"command": "/usr/bin/clang",
"args": [
"-g",
"${file}",
"-o",
"${fileDirname}/${fileBasenameNoExtension}",
"-fansi-escape-codes"
],
"group": "build",
"problemMatcher": ["$gcc"]
}]
}
launch.json 调试时必须指定 program 路径
点绿色三角调试报错 Cannot launch program ... because corresponding executable does not exist？说明 launch.json 里的 program 没和 tasks.json 输出路径对齐。
关键点：
-
program值必须和tasks.json中-o后的路径完全一致，比如"${fileDirname}/${fileBasenameNoExtension}" -
cwd设为"${workspaceFolder}"，避免相对路径解析失败 - macOS 上不用改
MIMode，默认lldb即可（gdb在 macOS 已被弃用） - 如果程序需 stdin 输入，勾选
externalConsole: true，否则调试控制台不响应输入
最容易漏的是：没开 Run in Terminal（Code Runner 插件场景）。若用 Code Runner，右键 → “Run Code” 前，先 Cmd+, 打开设置搜 code-runner.runInTerminal，设为 true。
真正麻烦的不是配路径，而是 clang 版本、Xcode 命令行工具版本、SDK 版本三者隐式耦合——改一个就可能让 stdio.h 找不到或 std::vector 报错。所以别动系统 clang，也别信“重装 Xcode 解决一切”的说法，优先用 clang -v -E 看真实头文件路径，比猜强十倍。
