KMP项目可正常运行，但Xcode中共享模块无自动补全

检查Gradle接口生成配置 #

• 打开KMP模块的build.gradle.kts（或.gradle），确认iOS目标的框架配置正确，必须开启Swift接口生成：

  ios {
    binaries {
      framework {
        isStatic = true // 静态框架需明确配置
        transitiveExport = true
        generateSwiftInterface = true // 关键配置，确保生成Swift可识别的接口
      }
    }
  }
  

• 手动跑一遍框架构建：./gradlew iosArm64Framework（模拟器用iosX64Framework），然后去构建产物的.framework/Modules目录下，检查module.modulemap和Headers里的Swift接口文件是否完整、有无语法错误。

调整Xcode索引策略 #

• 打开Xcode的File > Project Settings，把构建系统换成Legacy Build System，部分KMP项目在新系统下索引逻辑存在兼容性问题。
• 终端执行命令禁用增量索引，强制全量索引：

  defaults write com.apple.dt.XCBuild EnableSwiftIncrementalIndexing NO
  

  重启Xcode再尝试。

修正Kotlin代码的Swift互操作性问题 #

• 不要用Kotlin的internal修饰符给iOS暴露接口，改用public；如果是Observable对象，用@Published标注属性。
• 数据类避免复杂泛型嵌套，Swift索引解析对部分泛型组合支持不佳。
• 使用协程时，确保kotlinx-coroutines-swift依赖配置正确，暴露给iOS的协程方法要符合Objective-C互操作要求，比如添加@ObjCName注解。

彻底重置Xcode索引缓存 #

• 按以下步骤操作，比常规清缓存更彻底：
  1. 关闭Xcode。
  2. 删除~/Library/Developer/Xcode/DerivedData中对应项目的文件夹。
  3. 删除~/Library/Caches/com.apple.dt.Xcode整个目录。
  4. 终端执行killall -9 SourceKitService，终结索引服务进程。
  5. 重新打开项目，等待索引完成。

排查依赖冲突 #

• 执行./gradlew dependencies查看iOS目标的依赖树，排查是否有重复或冲突的传递依赖（尤其是Swift/Objective-C库），必要时用exclude排除冲突项。

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