Swift包执行swift build时报错：无法构建Objective-C模块'Darwin'

我之前也碰到过完全一样的问题，这大概率是系统头文件路径被第三方文件干扰导致的，下面是具体的排查和解决步骤：

核心问题原因 #

Swift构建时会依赖系统的Darwin Objective-C模块，而你的/usr/local/include目录下存在一个自定义的stdbool.h文件，它和系统默认的/usr/include/stdbool.h重名了。这个自定义文件里又递归引用了<stdbool.h>，导致编译器报#include nested too deeply错误，最终无法正常构建Darwin模块，引发Swift包的清单解析失败。

解决方案步骤 #

1. 移走冲突的自定义头文件 #

首先备份并移除/usr/local/include下的stdbool.h：

sudo mv /usr/local/include/stdbool.h /usr/local/include/stdbool.h.bak

执行完后直接尝试重新构建Swift包：

swift build

如果问题解决，说明就是这个冲突文件导致的。后续如果需要用到这个自定义头文件，可以考虑修改它的引用路径，或者把它放到更特定的目录下，避免和系统头文件重名。

2. 检查并清理环境变量干扰 #

如果第一步没解决，可能是CPATH或C_INCLUDE_PATH环境变量强制让编译器优先加载/usr/local/include的头文件。可以临时取消这些变量测试：

unset CPATH
unset C_INCLUDE_PATH
swift build

如果此时构建成功，你需要修改你的shell配置文件（比如~/.zshrc、~/.bash_profile或~/.bashrc），找到设置这些变量的行，调整路径顺序，确保系统默认的头文件路径优先级更高，或者移除不必要的路径添加。

3. 重新配置Xcode命令行工具 #

有时候Xcode命令行工具的路径配置异常也会引发这类头文件问题。可以重新指定Xcode的开发路径：

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

验证配置是否生效：

xcode-select -p

确保输出是/Applications/Xcode.app/Contents/Developer而非单独的CommandLineTools路径。

内容的提问来源于stack exchange，提问作者lhowell