Swift Playgrounds中Sources文件夹Xcode自动补全失效求助

我之前也踩过这个坑——Swift Playground主文件的自动补全顺得很，但Sources文件夹里的文件只能调出“简易”补全菜单，连系统框架的提示都没有，太影响开发效率了！结合自己的踩坑经验，给你几个实用的解决方向：

1. 检查代码的访问级别 #

Sources目录下的代码默认是internal访问级别，虽然Playground主文件能正常访问，但Xcode的索引引擎有时候对非public的符号补全支持不太到位。试试给你需要补全的类、方法加上public修饰符：

// Sources/MyUIHelper.swift
import UIKit

public class MyUIHelper {
    public func createButton() -> UIButton {
        let button = UIButton(type: .system)
        // 这里应该就能正常触发UIButton的方法补全了
        return button
    }
}

2. 强制触发Xcode重新索引 #

有时候不是代码的问题，是Xcode的索引卡住了。不用手动找DerivedData文件夹，直接在Xcode里操作更方便：

• 关闭当前Playground，重启Xcode
• 顶部菜单选择File > Workspace Settings，点击Advanced按钮，然后选择Delete清空当前Playground的DerivedData
• 或者在Sources文件里随便输入一个字符再删掉，触发Xcode重新扫描当前文件

3. 确认Sources文件的类型 #

偶尔会遇到文件被误标记的情况：选中Sources里的文件，看右侧的Inspector面板，检查File Type是不是Swift Source Code。如果是其他类型，改成Swift源码类型试试。

4. 手动导入依赖框架 #

Sources里的文件属于独立的模块，不会自动继承主Playground里的框架导入。如果你要用到UIKit、Foundation这些框架，一定要在Sources文件的顶部手动导入：

// 必须加这一行，不然Xcode不知道你要用UIKit的API
import UIKit

5. 重置Playground项目 #

如果上面的方法都没用，大概率是当前Playground的配置文件损坏了。新建一个空白Playground，把原来Sources里的代码复制过去，一般就能恢复正常的自动补全了。

内容的提问来源于stack exchange，提问作者brendon-ai