Xcode打开SwiftPM项目时无法显示Examples目录下全部子文件夹

原因 #

• SwiftPM项目的结构完全由根目录下的Package.swift配置文件定义，Xcode仅会加载该文件中明确声明的Target、资源或目录。Finder中存在但未在Package.swift里注册的文件夹，不会被Xcode识别展示。
• 手动通过Xcode的「添加文件」或拖拽操作无法修改SwiftPM的核心配置，这些操作不会同步到Package.swift，因此重启或刷新项目后会失效。

解决方法 #

• 打开项目根目录下的Package.swift文件。
• 根据需求选择对应配置方式：
  1. 每个示例文件夹作为独立Target：在targets数组中添加对应Target声明，示例代码如下：

     targets: [
         // 已存在的主项目Target
         .target(
             name: "YourMainProject",
             dependencies: []),
         // 添加第一个示例Target
         .target(
             name: "Example1",
             path: "Examples/Example1"),
         // 依次添加剩余示例文件夹对应的Target
         .target(
             name: "Example2",
             path: "Examples/Example2"),
         // ... 其他示例Target
     ]
     

  2. Examples目录作为主项目的资源：如果示例文件夹是主项目的资源文件，修改主Target的resources配置，将Examples目录纳入处理范围：

     .target(
         name: "YourMainProject",
         dependencies: [],
         resources: [
             .process("Examples")
         ]),
     

• 保存Package.swift后，Xcode会自动重新加载项目，此时所有Examples子文件夹会在Xcode中显示。若未自动刷新，可通过菜单栏「File」→「Packages」→「Resolve Package Versions」手动触发。

内容的提问来源于stack exchange，提问作者Sébastien Stormacq