Xcode Playgrounds中Sources内Swift文件无法互相访问及调用报错

Xcode 12.4 带Sources目录的Playground Workspace，编译规则和普通iOS项目有本质差异，完全照搬普通项目的权限逻辑会踩坑：

• Sources目录下的所有Swift文件默认会被编译为一个独立的静态库模块，模块内代码按道理是可以跨文件互相访问的，你声明的public权限并不是跨文件找不到类的原因——90%的这类报错都来自Target配置错误，和代码本身写得对不对没关系。
• 早年相关社区的解决方案是针对Xcode 8及更早的Playground版本，这十几年Xcode改了好几次Sources的编译逻辑，老方案对12.4版本完全不适用。

按顺序排查调整，完全不需要把所有代码塞到一个超大文件里：

• 第一步：核对所有相关Swift文件的Target Membership
  打开Xcode右侧的文件检查器，找到LevelScene.swift、TitleScene.swift两个文件，确认Target勾选的是Sources对应的静态库目标，而非Playground主页面的运行目标。只要有一个文件勾错目标，两个文件就会被分到完全独立的编译单元里，哪怕类写了全公共权限，互相也找不到——这是该类报错最高发的原因。
• 第二步：理清模块间的访问规则
  不用额外给类加public权限做冗余操作，分两种场景对应调整：
  • 如果是Sources文件夹内部的两个Swift文件互相引用类：同属一个编译模块时，默认的internal权限就足够跨文件访问，不需要加任何import语句。
  • 如果是Playground的入口主页面代码要引用Sources里的类：必须在主页面代码最顶部导入对应模块——Xcode 12.4里Sources的模块名默认和你的Playground Workspace名称一致，比如你的Workspace叫SpriteKitGame.playgroundworkspace，就写import SpriteKitGame就行。
• 第三步：规避Xcode 12.4的已知编译bug
  这个版本的Xcode对SpriteKit项目的Playground有个已知问题：如果把Swift文件、.sks场景资源放在Sources的不同子文件夹里，跨子目录的Swift文件会被拆分到独立的编译片段中，直接导致跨文件找不到类。解决方法很简单：把所有关卡对应的Swift场景文件、配套的.sksk资源文件全部平铺在Sources根目录，不要建子文件夹做分类。
• 第四步：修正场景实例化的代码逻辑
  哪怕跨文件引用的问题解决了，你原来写的LevelScene(fileNamed: "LevelScene")在Playground环境里也会出问题：Sources里的资源是打包在独立的静态库bundle里的，直接传默认的bundle路径会找不到资源文件。正确的写法是手动指定资源所在的bundle：

  // 基于LevelScene类的位置定位资源bundle
  let resourceBundle = Bundle(for: LevelScene.self)
  guard let levelScene = LevelScene(fileNamed: "LevelScene", with: resourceBundle) else {
      fatalError("LevelScene场景加载失败")
  }
  

注意：不要为了图快把所有场景代码都塞到Playground主页面文件里，只要按上面的步骤调整Target配置，完全可以保持一个Swift文件对应一个SpriteKit场景的清晰项目结构。

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