【 Godot 4 学习笔记】字典(Dictionary )

最新推荐文章于 2026-06-25 08:20:37 发布

原创

最新推荐文章于 2026-06-25 08:20:37 发布 · 274 阅读

标签

#godot #学习 #笔记

收录于

在 Godot 4 中，Dictionary（字典） 是一种极其强大的内置数据类型，用于存储“键值对”（Key-Value pairs）。你可以把它想象成一个通过“名字”（键）来查找“东西”（值）的储物柜，而不是像数组那样通过数字索引来查找。

以下是 Godot 4 Dictionary 的完整用法指南：

1. 基础创建与语法

字典使用大括号 {} 定义。键（Key）和值（Value）之间用冒号 : 分隔，每一对之间用逗号 , 分隔。

# 创建一个空字典
var my_dict = {}

# 创建并初始化（键可以是字符串、数字等）
var player = {
    "name": "Hero",
    "level": 5,
    "hp": 100.0,
    "is_alive": true
}

# 静态类型定义（推荐 Godot 4 使用）
# 指定键必须是 String，值必须是 int
var scores: Dictionary[String, int] = {"Alice": 90, "Bob": 85}

2. 访问与修改数据

你可以通过方括号 [] 或 点号 .（仅限字符串键）来访问数据。

# --- 访问 ---
print(player["name"])      # 输出: Hero
print(player.level)        # 输出: 5 (仅当键是合法标识符时可用点号)

# --- 修改 ---
player["hp"] = 80          # 修改现有值
player["mana"] = 50