获取帮助
获取帮助并与其他 Skip 用户交流的最佳方式，是加入社区 Slack。在那里，你可以获得实时支持，也可以借助社区经验顺利推进项目。你还可以使用 Skip 讨论论坛 ↗提交反馈、提问，或搜索已有问题的解决方案。如需报告缺陷，请使用问题跟踪器 ↗。
在任何与技术问题相关的沟通中，请附上 skip checkup 命令的输出。
常见问题排查
Section titled “常见问题排查”Skip 的架构依赖 Swift Package Manager 构建插件系统。遇到意外问题时，通常最好先清理 Xcode 构建（Product → Clean Build Folder），并重置软件包（File → Packages → Reset Package Caches）。有时还需要重启 Xcode，甚至删除本地 DerivedData 目录和应用目录中的 .build 文件夹。
首次构建很慢或看似卡住
Section titled “首次构建很慢或看似卡住”首次构建 Skip 项目时，会下载所有必需的 Gradle 依赖项并构建 Compose 库。这可能需要数分钟，且下载量可能超过 1 GB。由于依赖会被缓存，后续构建会快得多。可以使用 --verbose 运行，或查看 Xcode 构建日志来确认进度。
更新 Skip 后出现“No such module”错误
Section titled “更新 Skip 后出现“No such module”错误”升级 Skip 版本后，可能需要重置软件包缓存。在 Xcode 中选择 File → Packages → Reset Package Caches，然后清理并重新构建。如果错误仍然存在，请删除项目目录中的 .build 文件夹。
找不到 Android 模拟器
Section titled “找不到 Android 模拟器”如果 Skip 报告没有正在运行的 Android 模拟器，请用 adb devices 确认列表中是否存在设备。可以先运行 skip android emulator create 创建模拟器，再运行 skip android emulator launch 启动它。详细说明请参阅 CLI 参考。
Gradle 构建失败
Section titled “Gradle 构建失败”Gradle 错误会显示在 Xcode 构建日志中。常见原因包括网络问题（Gradle 首次构建时需要联网解析依赖）、Java 版本不匹配，以及过期缓存。请运行 skip doctor 验证开发环境，并尝试删除项目目录中的 .build 文件夹以清除 Gradle 缓存。
Xcode 插件信任对话框
Section titled “Xcode 插件信任对话框”首次在 Xcode 中构建 Skip 项目时，可能会看到要求信任 Skip 构建插件的对话框。选择 Trust & Enable 即可继续。这是 Xcode 针对所有 SwiftPM 构建插件显示的标准安全提示。