常见问题

项目打开后，一些功能为什么暂时不可用？

项目相关模块采用渐进式启动。等待项目、引擎和资源完成初始化，并检查通知及输出面板。如果长时间没有恢复，再记录第一个错误进行排查。

切换项目之前需要做什么？

保存脚本、场景、动画和配置。项目切换会清理旧项目状态并重新初始化相关模块，不要在切换过程中继续提交资源或构建操作。

资源重命名后引用异常怎么办？

优先通过 PinK 的资源操作入口重命名。仅在文件系统中改名可能没有同步更新元数据和引用。检查资源操作结果、通知和依赖该资源的场景。

脚本示例中的 API 不存在怎么办？

先确认示例对应的 COCOS Creator 版本是否与项目一致。引擎 API 以项目版本的官方文档为准，不要混用其他大版本示例。

构建失败时先看哪里？

查看构建日志中最早出现的错误，而不是只看最后一行；再检查目标平台工具链、未保存配置、脚本错误和资源处理阶段。

如何反馈手册问题？

记录 PinK 完整版本、项目使用的 COCOS 版本、当前操作页面、实际行为和可复现步骤。不要在公开问题中附带账号、密钥或项目私有资源。