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

type_string

定义

type_string() 用来把一个"类型编号"转换成人类能看懂的"类型名称"。

Godot 内部用数字（0、1、2……）来表示不同的数据类型。比如 0 代表空类型（ Nil ），2 代表整数（ int ），3 代表浮点数（ float ）。但直接看数字很难懂，type_string() 就是帮你把这些数字翻译成文字。

这就像你打电话给客服，客服问你"请输入问题类型编号"，你输入 3，系统告诉你"您选择的是：浮点数"。

函数签名

C#

// C# 中没有直接等价函数
// 请使用 Variant.Type 枚举的 ToString()
// 或手动映射
public static string TypeString(Variant.Type type)

GDScript

func type_string(type: int) -> String

参数说明

参数	类型	必需	说明
type	int	是	Variant 类型的编号，通常由 typeof() 返回

返回值

String —— 对应类型的人类可读名称，如 "int"、"float"、"String"、"Nil" 等。

代码示例

C#

// C# 中直接使用枚举名称
Variant.Type type = Variant.Type.Int;
GD.Print(type.ToString()); // "Int"

// 检查变量类型
var value = 42;
GD.Print(value.VariantType.ToString()); // "Int"

// 实际使用：调试时打印变量类型
private void PrintType(Variant value)
{
    GD.Print($"变量类型：{value.VariantType}");
}

GDScript

# 基本用法：查看类型编号对应的名称
var name = type_string(TYPE_INT)  # "int"
var name2 = type_string(TYPE_FLOAT)  # "float"
var name3 = type_string(TYPE_NIL)  # "Nil"

# 配合 typeof() 使用：查看任意变量的类型名
var value = 42
var type_name = type_string(typeof(value))  # "int"

# 实际使用：调试时打印变量类型
func print_type(value):
    print("变量类型：", type_string(typeof(value)))

注意事项

• 此函数通常与 typeof() 配合使用：先用 typeof() 获取变量的类型编号，再用 type_string() 将编号转换成名称。
• C# 中没有 type_string() 的直接等价。请使用 Variant.Type 枚举的 .ToString() 方法，或者 value.VariantType 属性来获取类型信息。
• GDScript 中的类型常量（如 TYPE_INT、TYPE_FLOAT）定义在 @GlobalScope 中，可以直接使用。
• 如果传入了无效的类型编号，返回 "Nil"。