Godot运行时为节点创建绑定新脚本的导出问题及4.x可行性咨询

错误原因分析 #

• 文件读取失败：导出后res://路径下的文件会被打包到游戏资源包中，旧的File API直接调用无法正确访问资源，导致get_as_text()触发“文件未打开”错误。
• 脚本继承不兼容：你绑定的code.gd继承了与KinematicBody2D不兼容的类型（比如Reference），无法挂载到目标节点上。

修复步骤 #

1. 修正文件读取逻辑（Godot 3.5） #

替换旧的File API为官方推荐的FileAccess，并添加错误检查，确保导出后能正确读取脚本内容：

extends Node2D

func _ready():
    var object = $Obj # type KinematicBody2D
    var code_path = "res://code.gd"
    
    # 使用FileAccess读取，兼容导出后的资源访问逻辑
    var file = FileAccess.open(code_path, FileAccess.READ)
    if not file:
        print("无法打开文件: ", code_path)
        return
    
    var script_content = file.get_as_text()
    file.close()
    
    var new_script = GDScript.new()
    new_script.source_code = script_content
    # 设置资源路径到user目录，确保可写入
    new_script.resource_path = "user://new_script.gd"
    
    # 保存并重新加载脚本，添加错误判断
    if ResourceSaver.save(new_script.resource_path, new_script) != OK:
        print("保存脚本失败")
        return
    
    if not new_script.reload():
        print("重新加载脚本失败")
        return
    
    # 检查脚本继承是否与目标节点兼容
    if new_script.instance_base.is_class("KinematicBody2D") or new_script.instance_base.is_class("Node2D"):
        object.set_script(new_script)
        # 手动调用_ready（注意：确保脚本内的_ready逻辑安全）
        if object.has_method("_ready"):
            object._ready()
    else:
        print("脚本继承类型不兼容: ", new_script.instance_base)

2. 确保脚本继承正确 #

修改code.gd的第一行，让它继承与KinematicBody2D兼容的父类：

extends KinematicBody2D
# 或 extends Node2D（只要是KinematicBody2D的父类均可）

# 你的脚本逻辑...

3. 导出设置注意事项 #

• 打开项目导出设置，在“资源”选项卡中确认res://code.gd未被排除在打包资源外；
• 如果需要从外部加载脚本（不打包进资源包），可将脚本放在user://目录，或在导出时保留该文件的原始目录结构。

Godot 4.x中的可行性 #

该操作在Godot 4.x中同样可行，仅需适配API变化：

• File被完全替换为FileAccess；
• 节点类型有变更，比如KinematicBody2D改名为CharacterBody2D；
• 脚本绑定逻辑与3.5基本一致。

示例代码（Godot 4.x）：

extends Node2D

func _ready():
    var object = $Obj # type CharacterBody2D
    var code_path = "res://code.gd"
    
    var file = FileAccess.open(code_path, FileAccess.READ)
    if not file:
        print("无法打开文件: ", code_path)
        return
    
    var script_content = file.get_as_text()
    file.close()
    
    var new_script = GDScript.new()
    new_script.source_code = script_content
    new_script.resource_path = "user://new_script.gd"
    
    if ResourceSaver.save(new_script.resource_path, new_script) != OK:
        print("保存脚本失败")
        return
    
    if not new_script.reload():
        print("重新加载脚本失败")
        return
    
    if new_script.instance_base.is_class("CharacterBody2D") or new_script.instance_base.is_class("Node2D"):
        object.set_script(new_script)
        if object.has_method("_ready"):
            object._ready()
    else:
        print("脚本继承类型不兼容: ", new_script.instance_base)

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