必须使用 Apple 官方 clang（≥15）并配置 tasks.json 显式传参：-x objective-c、-fobjc-arc、-framework Foundation、-isysroot SDK路径；Homebrew llvm 不含 Foundation，无法识别 @autoreleasepool 和 NSString；VSCode 仅编辑，不支持 OC 调试。
clang 必须是 Apple 官方版本，不是 Homebrew 的 llvm
VSCode 本身不参与编译，但你调用的 clang 必须能识别 @autoreleasepool、NSString 和 #import <Foundation/Foundation.h>。Homebrew 安装的 llvm（比如 clang --version 显示 clang version 18.1.8 (https://github.com/llvm/llvm-project)）完全不行——它没有 Foundation 头文件，链接时直接报 Undefined symbols for architecture x86_64: "_OBJC_CLASS_$_NSAutoreleasePool"。
必须执行以下三步验证：
-
xcode-select --install（不是只打开 Xcode.app） -
xcode-select -p输出必须是/Applications/Xcode.app/Contents/Developer；若为/Library/Developer/CommandLineTools，运行sudo xcode-select --switch /Applications/Xcode.app -
clang -v第一行必须含Apple clang字样，且版本 ≥ 15（Xcode 15.4+ 更稳）
tasks.json 里漏掉 -x objective-c 或 -isysroot 就会编译失败
VSCode 的 C/C++ 扩展默认把 .m 当纯文本，不触发任何构建逻辑。你得手动写 tasks.json，且参数不能少：
-
"type": "shell"—— 不要用cppbuild，它会加-std=c++17等破坏 OC 语义的 flag -
"command": "/usr/bin/clang"—— 用which clang确认路径，避免 PATH 混淆 -
"args"至少包含："-x","objective-c"（否则当 C 文件处理，拒识@interface）、"-fobjc-arc"、"-framework","Foundation"、"-isysroot",/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk - 输出路径用
"-o","${fileDirname}/${fileBasenameNoExtension}"—— 避免空格或中文路径导致 shell 解析失败
c_cpp_properties.json 只影响跳转，配错反而让 NSLog 标红
这个文件不参与编译，只控制 IntelliSense（Ctrl+Click 跳转、补全）。但乱设 includePath 或 macFrameworkPath 会导致大量 “symbol not found” 报错，甚至 NSLog 都标红。
如果你只写命令行编译（不依赖 VSCode 补全），建议干脆不配 c_cpp_properties.json。非要配，只填两项：
"compilerPath": "/usr/bin/clang""macFrameworkPath": ["/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX.sdk/System/Library/Frameworks"]
别碰 includePath 里硬塞 Foundation 路径——clang 本身通过 -framework Foundation 自动找头文件，IntelliSense 却会因路径重复或缺失而混乱。
VSCode 无法调试 Objective-C，launch.json 是摆设
VSCode 的 cppdbg 调试器不支持 Objective-C 运行时上下文：没法解析 [obj method] 消息发送、不识别 ARC 内存模型、断点常失效。即使 tasks.json 编译成功，launch.json 里写 "MIMode": "lldb" 也大概率卡在启动阶段或跳过断点。
真实可行的做法只有两种：
- 终端手动运行：
./main（编译后） +lldb ./main（需要手写breakpoint set -n main等命令） - 用 Xcode 创建 Command Line Tool（Language: Objective-C），它自动生成 Build Settings、Linking Flags 和完整调试支持——VSCode 只当编辑器用
别花时间折腾 preLaunchTask 和 program 路径匹配；Objective-C 的调试链路在 VSCode 中本质断裂，这不是配置疏漏，是能力边界。
