Kotlin Multiplatform项目中Xcode导入shared模块突然显示为空的问题求助

这种情况我之前维护KMP项目时也踩过类似的坑，大概率是版本不兼容、框架生成缓存或者配置细节出了问题，结合你贴的build.gradle.kts配置，给你几个具体的排查和解决步骤，你可以一步步试：

首先，先解决配置里的核心隐患：Kotlin插件版本不一致 #

你现在手动指定了kotlin("plugin.serialization") version "1.9.0"，但项目的Kotlin Multiplatform插件是通过libs.plugins.kotlinMultiplatform引入的——如果你的libs.versions.toml里Kotlin版本不是1.9.0，就会出现版本不兼容，直接导致shared框架生成不完整，Xcode自然看不到内容。

解决方式：
把serialization插件的版本改成和项目Kotlin版本完全一致：

• 如果你的根项目Kotlin版本是1.9.20，就改成：

  kotlin("plugin.serialization") version "1.9.20"
  

• 更推荐的做法是去掉手动指定的version，让它自动继承项目的Kotlin版本（前提是根项目已经统一配置了Kotlin版本）：

  kotlin("plugin.serialization")
  

第二步：彻底清理重建，排除缓存残留 #

缓存是这类问题的重灾区，按这个顺序操作别跳步：

1. 终端执行Gradle清理和重新生成Pod依赖：

   ./gradlew clean shared:podInstall
   

2. 打开Xcode，按下Shift+Cmd+K清理项目的Build Folder
3. 切换到iosApp目录，重新执行：

   pod install
   

4. 关闭Xcode，重新打开iosApp.xcworkspace

第三步：调整CocoaPods框架配置 #

你当前配置的是动态框架（isStatic = false），KMP的动态框架在部分Xcode版本下会有生成缺陷，试试改成静态框架：
修改cocoapods块里的framework配置：

framework {
    baseName = "shared"
    isStatic = true
}

改完后重新执行上面的清理重建步骤，静态框架的兼容性更好，Xcode更容易识别到内部的类和方法。

第四步：检查Xcode里的框架引用状态 #

如果前面几步都没解决，检查Xcode的配置细节：

1. 打开iosApp项目，进入Frameworks, Libraries, and Embedded Content面板
2. 看看shared.framework是否存在，如果显示红色感叹号，先移除它，然后点击+按钮，选择项目根目录下的shared/build/cocoapods/framework/shared.framework重新添加
3. 检查Build Settings里的Framework Search Paths，确认包含../shared/build/cocoapods/framework这个路径，没有的话手动添加

第五步：排查第三方插件的兼容性 #

你用的kmp-nativecoroutines是1.0.0-ALPHA-45的测试版，测试版插件很可能存在兼容性问题，建议先临时注释掉这个插件和相关依赖，重新生成框架：

• 注释掉id("com.rickclephas.kmp.nativecoroutines")这一行
• 注释掉commonMain.dependencies里的implementation("com.rickclephas.kmp:kmp-nativecoroutines-core:1.0.0-ALPHA-45")
  然后重新执行清理重建，如果此时Xcode里的shared模块正常显示了，那就是这个测试版插件的问题，换成稳定版或者更新的测试版即可。

额外提醒：Xcode版本匹配 #

如果是Xcode更新后出现的问题，确认你的Xcode版本和Kotlin版本兼容，比如Xcode 15需要Kotlin 1.9.20及以上版本支持，对应升级Kotlin插件版本即可。

按上面的步骤一步步排查，应该能解决shared模块为空的问题。

内容来源于stack exchange