Godot报错:Class "Recipe"隐藏全局脚本类,自定义资源均受影响
问题现象
- 项目内所有自定义资源均触发
Class "[类名]" already exists.错误(示例类为Recipe) - 未将类设置为单例,也未在任何代码中定义
class_name - 已尝试将资源文件移至新文件夹、新建项目,问题仍未解决
解决方案
- 清理导入缓存文件:删除项目根目录下的
.import文件夹,重启Godot后会自动重新生成导入配置,避免旧的资源引用残留。 - 排查自动加载与全局脚本:进入
项目设置 -> 自动加载检查是否存在重复的资源条目;排查全局脚本中是否通过preload/load重复加载了同一资源类。 - 检查资源重名:确认项目中是否存在不同路径下的同名资源文件(如两个
Recipe.gd),重命名冲突文件并更新所有相关引用。 - 清除项目缓存:删除项目根目录的
.godot缓存文件夹,重启Godot让其重新生成项目缓存信息,清除旧的类注册记录。 - 检查继承链:如果自定义资源继承了其他自定义类,检查父类文件是否存在副本或被重复引用的情况,确保父类仅被正确加载一次。
内容的提问来源于stack exchange,提问作者xPuv
相关产品推荐
相关产品推荐

