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

str

定义

str() 是一个万能转换器——你可以把任何类型的数据（数字、布尔值、向量等等）传给它，它会帮你转换成一段文字（字符串）。

想象你在填表格时，需要把年龄（数字）、是否会员（是/否）、住址（文字）都写进"备注"栏。你不能直接把数字和布尔值塞进文字栏，得先"翻译"成文字。str() 就是这个"翻译员"。

如果你传入多个参数，它会先把每个参数都转换成文字，然后拼接在一起，变成一整段话。

函数签名

C#

// C# 中没有直接等价的 str() 函数
// 请使用 .ToString() 或字符串插值
string result = value.ToString();
string combined = $"{value1}{value2}";

GDScript

func str(...) -> String

参数说明

参数	类型	必需	说明
...（可变参数）	Variant（任意类型）	是	传入一个或多个任意类型的值，它们会被转换成字符串并拼接在一起

返回值

String —— 所有参数转换成字符串后拼接在一起的结果。

代码示例

C#

// 将数字转换为字符串
int score = 100;
string scoreText = score.ToString(); // "100"

// 拼接多个值为一段文字
int health = 80;
bool alive = true;
string info = $"{health}{alive}"; // "80True"

// 实际使用：构建提示文字
string message = $"得分：{score}，生命值：{health}";
// "得分：100，生命值：80"

GDScript

# 将数字转换为字符串
var score = 100
var score_text = str(score)  # "100"

# 拼接多个值
var health = 80
var alive = true
var info = str(health, alive)  # "80true"

# 实际使用：构建提示文字
var message = str("得分：", score, "，生命值：", health)
# "得分：100，生命值：80"

注意事项

• C# 中没有 str() 的直接等价函数。请使用 .ToString() 进行单个值的转换，或使用字符串插值 $"{...}" 拼接多个值。
• GDScript 的 str() 可以接受任意数量的参数，所有参数会被转换为字符串后依次拼接。
• str(null) 在 GDScript 中会返回 "null"。
• 如果只需要拼接字符串而不需要转换类型，GDScript 中也可以直接用 + 运算符。