最后同步日期：2026-04-15 | Godot 官方原文 — @GlobalScope

类型转换与工具

想象你有一个工具箱，里面有各种万能工具。类型转换与工具函数就是 Godot 引擎的万能工具箱，帮你在不同数据类型之间转换、加载资源、计算哈希等。

核心概念

• load / preload：加载资源文件（图片、音频、场景等）。
• 序列化：var_to_str / str_to_var 将数据转为字符串或还原。
• hash：计算数据的哈希值，用于快速比较。
• instance_from_id：通过实例 ID 获取对象引用。

---

函数总览

函数名	描述	使用频率	详细文档
bytes_to_var	将字节数组反序列化为 Variant	★★	查看
error_string	将错误码转换为可读字符串	★★	查看
hash	对 Variant 计算哈希值	★★★	查看
instance_from_id	根据实例 ID 获取 Object	★★	查看
is_instance_id_valid	检查实例 ID 是否指向有效对象	★★★★	查看
is_instance_valid	检查 Object 实例是否有效	★★★★	查看
load	从文件路径加载资源（运行时）	★★★★★	查看
preload	在脚本解析时预加载资源	★★★★★	查看
str	将 Variant 转换为字符串	★★★★★	查看
str_to_var	将字符串解析为 Variant	★★	查看
type_string	获取 Variant 类型的名称字符串	★★★★★	查看
var_to_str	将 Variant 序列化为字符串	★★	查看
weakref	为对象创建弱引用	★★	查看