macOS: 在绑定.gyp 时,如果没有设置 SDKROOT,则 gyp 会忽略 -isysroot,导致 clang 通过忽略 DEVELOPER_DIR/xcode-select 的路径来解析 SDK

错误描述

在 macOS 上，node-gyp rebuild 会调用 clang++，但没有 -isysroot 或 --sdk。这使得 Clang 驱动器回退到其内部调用 xcrun --show-sdk-path（没有 --sdk 参数）。通过 xcrun -v 验证了此特定调用变体通过硬编码的缓存键解析为 /Library/Developer/CommandLineTools/SDKs/MacOSX.sdk - 独立于 xcode-select/DEVELOPER_DIR，以及独立于实际调用的 clang++ 二进制文件的 Xcode 工具链。 （相比之下，xcrun --sdk macosx --show-sdk-path - 即具有明确的 SDK 名称 - 会尊重 DEVELOPER_DIR/xcode-select。）

在系统中，操作系统已更新（更新了独立的 CommandLineTools SDK），但选定的 Xcode.app 尚未更新，这将新的 SDK 的 libc++ 头文件（引用了像 __builtin_ctzg/__builtin_clzg 这样的内置函数，需要 Clang >= 19）与旧的嵌入式 Clang（来自 Xcode 16.2）结合起来，产生：

error: use of undeclared identifier '__builtin_ctzg'

gyp 代码中的根原因

gyp/pylib/gyp/xcode_emulation.py 已经包含避免此问题的逻辑，通过明确命名 SDK 来查询 xcrun，并通过传递 -isysroot：

# GetSDKVersionInfoItem
return GetStdoutQuiet(["xcrun", "--sdk", sdk, infoitem])  # explicit --sdk, respects DEVELOPER_DIR