如何通过脚本在Godot中移动Resource且不破坏引用

核心API：EditorFileSystem.move_file() #

Godot编辑器内置了专门的API来处理带引用更新的文件移动，和手动操作编辑器的效果完全一致，无需手动修改引用。

实现步骤 #

• 编写编辑器脚本（需添加@tool注解，或作为插件运行）
• 通过EditorFileSystem单例调用move_file方法，示例代码：

@tool
func move_resource_with_references(source_path: String, target_path: String) -> bool:
    var editor_fs = EditorFileSystem.get_singleton()
    # 检查源文件是否存在
    if not editor_fs.file_exists(source_path):
        print("源文件不存在")
        return false
    # 检查目标路径是否已存在文件
    if editor_fs.file_exists(target_path):
        print("目标路径已存在同名文件")
        return false
    # 执行移动并更新所有引用
    var success = editor_fs.move_file(source_path, target_path)
    return success

关键说明 #

• move_file会自动扫描项目中所有引用该资源的场景、脚本、其他资源，批量更新路径引用
• 路径必须使用res://开头的项目相对路径，不支持绝对路径
• 该API仅在编辑器环境下可用，运行时无法调用（EditorFileSystem是编辑器专属类）
• 如需提前查看所有引用，可调用editor_fs.find_references_to_file(source_path)获取引用文件列表

内容的提问来源于stack exchange，提问作者Programmer9000