macOS安装SaxonC Python扩展执行build_ext报clang错误如何解决

该报错是SaxonC 11版本Python绑定在macOS环境下安装的典型问题，核心触发逻辑是：执行本地编译步骤时，clang编译器按照安装脚本里写死的相对路径../DocumentBuilder.cpp查找C++源文件失败，本质是路径匹配错误，和clang本身、Python环境没有直接关系。
常见的触发场景包括三类：

• 下载的SaxonC安装包解压不完整，上层目录缺失对应的C++实现源文件
• 执行编译命令时所在的工作目录错误，没有进入脚本要求的Python绑定子目录
• SaxonC 11的官方安装脚本存在硬编码路径bug，没有适配macOS版本安装包的目录结构，默认写的源文件路径和实际存放位置不一致

按以下顺序逐一排查即可：

1. 校验安装包完整性
   在解压后的SaxonC根目录下全局搜索DocumentBuilder.cpp文件：
   • 如果搜索不到对应文件，说明安装包损坏或者下载的版本不对，重新获取完整的对应macOS架构的SaxonC安装包，完整解压后再操作
   • 如果能找到该文件，记录下它相对于saxon-setup.py文件所在位置的相对路径
2. 修正执行命令的工作目录
   按照安装要求，执行python3 saxon-setup.py build_ext -if命令前，必须先进入SaxonC安装目录下的Saxon.C.API/python-saxon子目录，不要在安装包根目录或其他任意路径下直接执行命令，切换目录后重新运行编译命令测试。
3. 修复脚本硬编码路径
   如果切换目录后仍然报相同错误，打开当前目录下的saxon-setup.py文件，找到所有带../前缀的cpp源文件路径配置项，把这些路径统一替换为之前查到的源文件实际相对路径。比如如果源文件实际存放在上层目录的Saxon.C.API文件夹下，就把原脚本里的../DocumentBuilder.cpp修改为../Saxon.C.API/DocumentBuilder.cpp，其余同前缀的cpp文件路径同步修正，保存后重新执行编译命令即可。
4. 跳过本地编译直接安装
   不想手动改脚本的话，可以直接安装预编译好的SaxonC Python官方包，跳过本地编译环节，执行以下命令即可：

   pip3 install saxonche
   

   安装完成后直接在代码中导入saxonche模块即可正常使用XSL转换、XML处理相关功能，不需要再手动执行build_ext步骤。

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