Swift Package导入自定义非系统C模块出现Module not found错误如何解决?
问题核心原因
你的Swift包配置存在路径规则冲突、公共头导出规则缺失两个问题,导致外部项目无法正确识别模块:
- C类型的target默认需要明确配置公共头导出规则,你当前仅配置了内部头搜索路径,没有声明暴露给外部的头文件范围
- target的
path设为Sources的同时额外添加了CModule的头搜索路径,路径规则冲突,SPM无法生成正确的模块映射
解决步骤
- 首先调整
Package.swift配置,修正路径和导出规则:
// swift-tools-version:5.3 import PackageDescription let package = Package( name: "CModule", products: [ .library( name: "CModule", targets: ["CModule"]), // 不强制指定dynamic类型,让Xcode根据项目需求自动选择链接方式,避免动态库部署问题 ], targets: [ .target( name: "CModule", dependencies: [], // 直接指定target对应到C模块的具体目录 path: "Sources/CModule", // 声明当前目录为公共头路径,SPM会自动识别该目录下的头文件 publicHeadersPath: "." ) ] )
- 检查
Sources/CModule目录下的文件,确保存在和模块同名的伞头文件CModule.h,所有需要暴露给Swift调用的头文件都要在CModule.h中通过#include引入 - 如果需要自定义模块映射规则,可以在
Sources/CModule目录下新增module.modulemap文件,内容如下:
module CModule { umbrella header "CModule.h" export * }
- 提交C模块本地仓库的所有修改:SPM拉取本地包时会读取仓库的提交版本,未提交的修改不会同步到导入的项目中
- 重新将本地包添加到Swift项目,添加后检查项目target的Frameworks, Libraries, and Embedded Content设置中已经勾选了CModule库,同时在Build Phases -> Link Binary With Libraries列表中确认C模块存在
额外排查点
如果修改后仍然报错,可以在项目的Build Settings中搜索Swift Compiler - Search Paths,在Import Paths配置项中手动添加$(BUILT_PRODUCTS_DIR)并设置为递归查询。
内容的提问来源于stack exchange,提问作者thanat0sis
相关产品推荐
相关产品推荐

