尧图网页设计 
1. 从“容器”到“瑞士军刀”重新认识Godot的Array如果你是从C、Java或者C#这类强类型语言转战Godot的第一次看到Array这个类型可能会觉得它平平无奇不就是个动态数组嘛。但如果你真这么想那可就错过了Godot引擎里这把最趁手的“瑞士军刀”。在Godot里Array远不止是一个简单的数据容器它融合了列表、栈、队列、集合去重、映射键值对查找等多种数据结构的核心操作并且通过一套极其简洁、统一的API暴露给你。我刚开始用Godot时也习惯性地去定义各种结构体struct或者用Dictionary来管理复杂数据直到有一次为了优化一段物品管理代码我仔细对比了Array和Dictionary在纯遍历和查找上的性能并深入阅读了部分源码才发现Array在Godot内部的优化程度非常高。对于顺序访问、尾部增删这类操作它的效率非常可观。更重要的是它的typed array类型化数组在4.0之后得到了极大增强让你在享受动态类型便利的同时也能在需要时获得近乎静态类型的安全性和性能。简单来说Godot的Array是一个动态的、可包含任意类型Variant的、内置了丰富高阶方法的集合类。它解决了游戏开发中那些高频但琐碎的数据操作需求比如快速过滤出所有攻击力大于50的武器、对一批敌人按距离排序、或是高效地合并和去重多个掉落物品列表。本文将带你彻底拆解Godot 4.2中Array的每一个核心特性和使用技巧让你能像使用自己的手脚一样熟练地运用它。2. 创建与初始化不止是[]那么简单创建一个Array最直观的方式就是使用字面量[]。但根据不同的使用场景Godot提供了多种初始化方式选择合适的一种能让代码意图更清晰有时甚至能提升性能。2.1 基础创建与字面量最常用的就是直接赋值var my_array [] # 创建一个空数组 var numbers [1, 2, 3, 4, 5] # 创建并初始化一个整数数组 var mixed [1, hello, true, Vector2(1, 2)] # Godot数组可以混合存放任何类型这种混合类型的能力是Array灵活性的基础但也可能是bug的温床我们后面会讲到如何用类型化数组来约束它。2.2 使用Array()构造方法Array构造方法接受一个可选参数用于从其他可迭代对象创建数组。这在转换数据时非常有用。var str Hello var char_array Array(str) # 结果为 [H, e, l, l, o] 将字符串拆分为字符数组 var dict {a: 1, b: 2} var keys_array Array(dict) # 注意结果不是[{a:1}, {b:2}]而是[a, b]。这里迭代的是字典的键。 # 如果想得到键值对数组通常使用 dict.keys() 和 dict.values()或者用 map 方法。这里有一个非常重要的坑需要提醒直接使用Array(dictionary)得到的并不是包含键值对对象的数组而是由字典的键keys组成的数组。这个行为与遍历字典for key in dict:的行为一致但如果你预期的是键值对就会出错。正确的做法是var dict {a: 1, b: 2} # 方法1分别获取键和值 var keys dict.keys() var values dict.values() # 方法2使用map生成键值对数组例如元组数组 var pairs dict.keys().map(func(key): return [key, dict[key]])2.3 类型化数组兼顾灵活与安全这是Godot 4.x版本中一个至关重要的特性。你可以为数组声明其允许存储的元素类型从而获得编辑器代码补全、静态类型检查和潜在的性能优化。# 语法 Array[Type] var ints: Array[int] [1, 2, 3] var strings: Array[String] [a, b, c] var nodes: Array[Node] [$Sprite2D, $Player] # 尝试放入错误类型会在编辑器中和运行时取决于设置报错 ints.append(hello) # 错误无法将String赋值给Array[int]中的元素 # 类型化数组也支持复杂的嵌套和自定义资源类型 var array_of_arrays: Array[Array] [[1,2], [3,4]] var inventory: Array[InventorySlot] [] # 假设InventorySlot是一个自定义Resource为什么推荐使用类型化数组代码清晰与安全它作为文档明确了数组的用途编译器能提前阻止类型错误。编辑器支持在VS Code或Godot内置编辑器中对类型化数组进行遍历或访问元素时能获得正确的类型提示和自动补全。性能虽然Godot内部Array始终存储Variant但明确的类型信息有时能让引擎生成更优化的代码尤其是在AOT编译如GDExtension场景下。2.4 工厂方法Array.makeArray.make用于快速创建一个填充了默认值的数组。这在需要预定长度的数组时非常方便比如一个固定大小的环形缓冲区。# Array.make(value: Variant, count: int) - Array var zeroes Array.make(0, 10) # 创建包含10个0的数组[0, 0, 0, ...] var nulls Array.make(null, 5) # 创建包含5个null的数组 var vectors Array.make(Vector2.ZERO, 8) # 创建包含8个Vector2.ZERO的数组需要注意的是Array.make创建的是浅拷贝。如果value是引用类型如Array,Dictionary, 自定义Resource那么数组中的所有元素都是对同一个对象的引用。修改其中一个会影响所有。var inner [1, 2] var array_of_arrays Array.make(inner, 3) # array_of_arrays 现在是 [[1,2], [1,2], [1,2]] array_of_arrays[0].append(3) # 现在 array_of_arrays 变成了 [[1,2,3], [1,2,3], [1,2,3]] 因为三个元素引用的是同一个列表对象。3. 核心操作增删改查的哲学Array的核心操作API设计得非常直观但其中一些方法的细节和性能特征需要了然于胸。3.1 增append,push_back,insertappend(value)/push_back(value)在数组末尾添加一个元素。这是时间复杂度为O(1)摊销的操作是最快的添加方式。var arr [1, 2] arr.append(3) # arr 变为 [1, 2, 3] arr.push_back(4) # arr 变为 [1, 2, 3, 4] (append的别名)insert(position: int, value: Variant)在指定索引处插入一个元素。这是一个O(n)的操作因为插入点之后的所有元素都需要向后移动一位。在循环中频繁使用insert(0, value)在头部插入是性能陷阱。var arr [b, c] arr.insert(0, a) # 在头部插入arr 变为 [a, b, c] arr.insert(2, d) # 在索引2处插入arr 变为 [a, b, d, c]实操心得如果你需要维持一个顺序列表并且频繁地在两端添加元素考虑使用append尾部并结合一个索引来模拟头部操作或者评估是否LinkedListGodot没有内置需自己实现更合适。对于大多数游戏开发场景如管理 spawned enemies, collected itemsappend足以应对。3.2 删pop_at,pop_back,pop_front,remove_at,clearpop_at(position: int)移除并返回指定索引处的元素。这也是一个O(n)操作。pop_back()移除并返回最后一个元素。O(1)。pop_front()移除并返回第一个元素。O(n)因为需要移动所有剩余元素。remove_at(position: int)移除指定索引处的元素不返回。O(n)。clear()清空数组移除所有元素。O(n)因为要释放每个元素但通常很快。var arr [a, b, c, d, e] var last arr.pop_back() # last e, arr [a, b, c, d] var first arr.pop_front() # first a, arr [b, c, d] var middle arr.pop_at(1) # middle c, arr [b, d] arr.remove_at(0) # arr [d] arr.clear() # arr []性能警告pop_front()和remove_at(0)在长数组上频繁调用会是性能瓶颈。如果你需要“先进先出”FIFO的队列行为考虑使用append配合一个pop_front但要注意性能。对于高性能要求的队列更好的模式是使用append并维护一个“头指针”索引避免实际的数据移动。3.3 改直接索引赋值修改数组元素最简单直接。var arr [10, 20, 30] arr[0] 100 # arr [100, 20, 30] arr[-1] 300 # 支持负索引-1表示最后一个元素。arr [100, 20, 300]注意边界尝试访问或赋值超出数组范围的索引如arr[10]会导致运行时错误。务必确保索引有效。3.4 查索引、find、has、count索引访问arr[index] O(1)。find(what: Variant, from: int 0) - int从from索引开始查找第一个匹配what的元素的索引找不到则返回-1。这是一个O(n)的线性搜索。var arr [apple, banana, cherry, banana] var idx arr.find(banana) # idx 1 idx arr.find(banana, 2) # 从索引2开始找 idx 3 idx arr.find(durian) # idx -1rfind(what: Variant, from: int -1) - int反向查找。has(value: Variant) - bool检查数组是否包含某个值。内部就是调用find() ! -1。O(n)。count(value: Variant) - int计算某个值在数组中出现的次数。O(n)。var arr [1, 2, 2, 3, 2] var has_two arr.has(2) # true var num_twos arr.count(2) # 3重要提醒find、has、count都是线性搜索。如果你的数组很大比如上千个元素并且需要频繁进行存在性检查或计数使用Array可能不是最优解。考虑使用Dictionary键值对或SetGodot 4.1 引入基于Dictionary来获得O(1)的查找性能。例如如果你只关心某个ID是否存在用一个Dictionary来记录ID - true会比在Array里反复find快得多。4. 迭代与遍历多种姿势各取所需遍历数组是日常操作Godot提供了多种方式。4.1for循环最通用var fruits [Apple, Banana, Orange] for i in range(fruits.size()): print(Index %d: %s % [i, fruits[i]]) # 需要索引时用这个4.2for-in循环最简洁不需要索引时for fruit in fruits: print(fruit) # 直接获取元素4.3for-in带索引使用enumerate类似Python这是我最推荐的方式结合了简洁和索引信息。for index in fruits.size(): var fruit fruits[index] print(Index %d: %s % [index, fruit]) # 或者如果你喜欢更函数式的风格Godot 4.0 for i in fruits.size(): print(Index %d: %s % [i, fruits[i]])注意Godot的for index in array.size()是一种习惯用法array.size()返回的是整数范围。4.4while循环更灵活的控制当你需要在遍历中根据条件动态改变索引时比如跳过某些元素while循环更合适。var i 0 while i arr.size(): if some_condition(arr[i]): i 2 # 跳过下一个元素 else: process(arr[i]) i 15. 高阶函数让代码更声明式Godot 4.0为Array引入了类似JavaScript/Python的函数式编程方法这极大地提升了代码的表达能力。这些方法通常返回一个新数组不会修改原数组除非特别说明。5.1map(callable: Callable) - Array将数组中的每个元素通过一个函数进行转换返回由结果组成的新数组。var numbers [1, 2, 3, 4] var squares numbers.map(func(x): return x * x) # [1, 4, 9, 16] # 假设有一个Node数组 var enemies: Array[Node2D] get_tree().get_nodes_in_group(enemies) var enemy_positions enemies.map(func(enemy: Node2D): return enemy.global_position)map是数据转换的利器能避免显式的循环让意图更清晰。5.2filter(callable: Callable) - Array过滤出数组中满足条件的元素。var numbers [1, 2, 3, 4, 5, 6] var evens numbers.filter(func(x): return x % 2 0) # [2, 4, 6] # 过滤出还活着的敌人 var alive_enemies enemies.filter(func(enemy): return enemy.health 0)5.3reduce(callable: Callable, initial) - Variant将数组中的所有元素通过一个函数累积计算为一个单一的值。这是理解起来稍复杂但功能强大的函数。var numbers [1, 2, 3, 4] var sum numbers.reduce(func(accum, number): return accum number, 0) # 10 # 执行过程 (( (01) 2 ) 3 ) 4 # 找出最大血量 var max_health enemies.reduce(func(max_hp, enemy): return maxf(max_hp, enemy.health), 0.0)reduce的第一个参数是累积回调函数它接收两个参数当前的累积值和当前数组元素。第二个参数是累积的初始值。5.4any(callable: Callable) - bool/all(callable: Callable) - boolany: 判断数组中是否至少有一个元素满足条件。all: 判断数组中是否所有元素都满足条件。var has_any_dead enemies.any(func(enemy): return enemy.health 0) var all_alive enemies.all(func(enemy): return enemy.health 0)这两个函数在判断集合整体状态时非常方便避免了手动写循环和标志变量。5.5sort_custom(callable: Callable)/sorted(callable: Callable) - Array自定义排序。sort_custom会修改原数组而sorted返回排序后的新数组。 回调函数接受两个参数a和b如果希望a排在b前面则返回true。var players [...] # 假设是Player对象的数组 # 按分数降序排序 players.sort_custom(func(a, b): return a.score b.score) # 按距离玩家的升序排序 var player_pos $Player.global_position enemies.sort_custom(func(a, b): var dist_a a.global_position.distance_squared_to(player_pos) var dist_b b.global_position.distance_squared_to(player_pos) return dist_a dist_b # 距离小的排前面 )性能提示对于简单类型如整数、字符串的排序使用内置的sort()方法无参数性能更高因为它使用引擎内部优化过的比较逻辑。sort_custom由于需要频繁调用GDScript回调函数在排序大数组时会有额外开销。6. 实用工具方法去重、洗牌、切片与合并6.1 去重make_unique()make_unique()会原地修改数组移除所有重复的、相邻的元素只保留第一个。注意关键词“相邻”。这意味着它不会对数组进行全局去重除非数组已经排序。var arr1 [1, 2, 2, 3, 3, 3, 2, 1] arr1.make_unique() # arr1 变为 [1, 2, 3, 2, 1] (只去除了相邻的重复) var arr2 [1, 3, 2, 3, 1] arr2.make_unique() # arr2 不变因为重复的3和1都不相邻 # 要实现全局去重通常先排序 var arr3 [1, 3, 2, 3, 1] arr3.sort() arr3.make_unique() # arr3 变为 [1, 2, 3]如果你需要不改变顺序的全局去重一个常见的模式是使用Dictionary的键唯一性var arr [1, 3, 2, 3, 1] var dict {} for item in arr: dict[item] true var unique_arr dict.keys() # 注意keys()的顺序是插入顺序在Godot 3.x以后是稳定的所以这里能得到[1, 3, 2]6.2 洗牌shuffle()随机打乱数组元素的顺序。常用于抽奖、随机出敌等场景。var cards [A, K, Q, J, 10] cards.shuffle() # cards 现在是一个随机顺序例如 [Q, A, 10, J, K]6.3 切片slice(begin: int, end: int 2147483647, step: int 1, deep: bool false) - Array提取数组的一部分返回一个新数组。参数begin是起始索引包含end是结束索引不包含step是步长deep决定是否对引用类型元素进行深拷贝。var arr [0, 1, 2, 3, 4, 5, 6] var part1 arr.slice(2) # 从索引2到最后: [2, 3, 4, 5, 6] var part2 arr.slice(1, 5) # 索引1到4: [1, 2, 3, 4] var part3 arr.slice(0, 7, 2)# 从0到6步长为2: [0, 2, 4, 6] var reversed arr.slice(6, -1, -1) # 从6到开始步长-1: [6, 5, 4, 3, 2, 1, 0] (手动反转)关于deep参数默认是false即浅拷贝。如果数组元素是Array或Dictionary等新数组和原数组的元素指向同一个对象。如果设置为trueGodot会尝试递归地复制这些元素对于Resource这通常是深拷贝但对于Object如Node行为可能复杂通常不推荐对包含节点的数组进行深拷贝切片。6.4 合并操作符与append_array操作符连接两个数组返回一个新数组。var a [1, 2] var b [3, 4] var c a b # c [1, 2, 3, 4], a和b不变append_array(array: Array)将另一个数组的所有元素追加到当前数组的末尾。原地修改。var a [1, 2] var b [3, 4] a.append_array(b) # a 变为 [1, 2, 3, 4], b不变选择哪个取决于你是否需要保留原数组。append_array通常更高效因为它避免了创建新数组的开销。7. 性能考量与最佳实践在游戏开发中数据结构的性能至关重要。以下是一些关于Array性能的硬核知识和实践建议。7.1 理解时间复杂度O(1) (常数时间)通过索引访问(arr[i])、尾部追加(append/push_back)、尾部弹出(pop_back)、获取大小(size())。O(n) (线性时间)查找(find,has,count)、插入/删除非尾部元素(insert,pop_at,pop_front,remove_at)、包含回调的高阶函数(map,filter,sort_custom等因为它们至少需要遍历一次)。O(n log n)排序(sort())。黄金法则避免在循环内部对大型数组进行O(n)操作这会导致O(n²)的灾难性性能。例如不要在每一帧都find一个包含上千个元素的数组。7.2 预分配与内存Godot的Array是动态数组内部会预留一些额外容量capacity以避免每次append都重新分配内存。你可以通过resize()方法来手动调整大小但这通常不是必需的因为引擎的自动管理已经很好。resize()更大的尺寸会预分配内存resize()更小会释放多余内存并截断数组。var arr [] arr.resize(1000) # 预分配1000个元素的空间所有元素初始化为null arr[999] end # 可以直接访问 arr.resize(500) # 截断索引500-999的元素丢失对于已知最大大小的批量操作比如从文件加载1000个配置项预分配可以避免多次扩容带来的微小开销。但对于大多数情况相信append的摊销O(1)性能即可。7.3ArrayvsDictionaryvsPacked*ArrayArray擅长顺序访问和遍历。当你需要保持元素的插入顺序或者需要频繁按索引随机访问时用Array。Dictionary擅长按键快速查找(O(1))。当你需要通过一个唯一的键如字符串ID、整数ID来查找、插入、删除数据时用Dictionary。它不保证顺序虽然Godot 3.x后默认按插入顺序迭代。PackedByteArray、PackedInt32Array等这些是紧密打包的、类型单一的数组。它们的内存效率极高因为所有元素连续存储没有每个元素的Variant开销。用于存储大量同类型的简单数据如网格顶点、图像数据、网络数据包时性能远超普通Array。但它们只能存储基本类型整数、浮点数、字节等API也更基础。选择建议管理游戏实体列表如所有敌人、所有子弹用Array[Node2D]。通过ID快速查找物品属性如iron_sword - {damage: 10}用Dictionary。处理从网络接收的二进制协议数据用PackedByteArray。7.4 一个实战案例对象池的实现对象池是重用游戏对象如子弹、特效以减轻GC压力的经典模式。Array是实现简单对象池的绝佳选择。extends Node2D class_name BulletPool export var bullet_scene: PackedScene export var initial_pool_size: int 20 var _pool: Array[Node2D] [] var _available: Array[Node2D] [] func _ready(): # 预初始化对象池 for i in range(initial_pool_size): var bullet bullet_scene.instantiate() as Node2D bullet.visible false bullet.process_mode Node.PROCESS_MODE_DISABLED # 禁用物理处理 add_child(bullet) _pool.append(bullet) _available.append(bullet) # 可用列表 func get_bullet() - Node2D: if _available.is_empty(): # 池已空动态扩容或返回null取决于设计 var new_bullet bullet_scene.instantiate() as Node2D add_child(new_bullet) _pool.append(new_bullet) return new_bullet else: # 从可用列表尾部取出O(1) var bullet _available.pop_back() bullet.visible true bullet.process_mode Node.PROCESS_MODE_INHERIT return bullet func return_bullet(bullet: Node2D): if bullet in _pool: bullet.visible false bullet.process_mode Node.PROCESS_MODE_DISABLED bullet.global_position Vector2.ZERO # 重置状态 # 放回可用列表尾部O(1) if not bullet in _available: _available.append(bullet)在这个实现中我们用了两个Array_pool记录所有子弹实例_available作为一个栈后进先出来管理可用子弹。pop_back()和append()都是O(1)操作使得获取和归还子弹非常高效。同时类型化数组Array[Node2D]确保了类型安全。8. 常见陷阱与调试技巧即使是最简单的工具用不好也会踩坑。下面是一些我亲身经历或见别人踩过的Array相关的坑。8.1 浅拷贝与深拷贝这是引用类型语言中的经典问题。Array的赋值和参数传递是浅拷贝。var a [ [1, 2], [3, 4] ] # 二维数组 var b a.duplicate() # 默认是浅拷贝 b[0].append(99) print(a) # 输出 [[1, 2, 99], [3, 4]]因为a[0]和b[0]引用同一个内部数组 # 正确的深拷贝 var c a.duplicate(true) # 参数 deeptrue c[0].append(100) print(a) # 输出 [[1, 2, 99], [3, 4]] 不变 print(c) # 输出 [[1, 2, 99, 100], [3, 4]]duplicate(deep: bool false)方法用于复制数组。默认浅拷贝只复制数组结构本身内部的引用类型对象仍是共享的。深拷贝会递归复制所有元素但对于Node等复杂对象深拷贝可能不可行或不是你想要的行为。8.2 在迭代中修改数组绝对不要在for-in或for i in array.size()循环中直接添加或删除元素这会导致未定义行为很可能崩溃或跳过元素。# 错误示范 var arr [1, 2, 3, 4, 5] for num in arr: if num % 2 0: arr.erase(num) # 在迭代中删除危险 # 正确做法1先收集要处理的元素循环结束后再操作 var to_remove [] for num in arr: if num % 2 0: to_remove.append(num) for num in to_remove: arr.erase(num) # 正确做法2从后向前遍历索引适用于删除 for i in range(arr.size() - 1, -1, -1): if arr[i] % 2 0: arr.remove_at(i) # 从后往前删索引不会错乱 # 正确做法3使用 filter 高阶函数最简洁 arr arr.filter(func(x): return x % 2 ! 0)8.3 负索引与越界Godot支持负索引-1表示最后一个元素-2表示倒数第二个以此类推。这很方便但要小心计算。var arr [10, 20, 30] print(arr[-1]) # 30 print(arr[-3]) # 10 # print(arr[-4]) # 错误越界确保你的索引在-arr.size() index arr.size()范围内。8.4 类型化数组的运行时检查即使你声明了Array[int]在非严格类型检查模式下Godot编辑器默认错误的类型赋值在运行时可能不会立即报错但会导致后续难以调试的问题。建议在项目设置中开启“严格类型检查”或者在可能出问题的地方手动断言。var ints: Array[int] [1, 2, 3] ints.append(oops) # 在非严格模式下可能不会报错但破坏了类型约定 # 好的做法 if typeof(new_value) TYPE_INT: ints.append(new_value) else: push_error(Tried to append non-int to typed array.)8.5 使用调试工具print(arr)或printt(arr)快速打印整个数组。在编辑器的调试器“远程”视图中可以展开查看数组的每个元素对于复杂对象非常有用。使用assert进行防御性编程var index some_function() assert(index 0 and index my_array.size(), Index out of bounds!) var element my_array[index]Godot的Array是一个设计精良、功能丰富的工具。从简单的数据存储到复杂的数据转换再到高性能的游戏模式它都能胜任。理解其特性、性能边界和最佳实践能让你在Godot开发中更加游刃有余。记住没有最好的数据结构只有最合适的数据结构。Array是你的瑞士军刀但知道何时该换成专门的斧头Dictionary或锯子PackedArray才是资深开发者的标志。 Godot引擎Array数据结构全解析：从基础操作到高阶函数与性能优化
1. 从“容器”到“瑞士军刀”重新认识Godot的Array如果你是从C、Java或者C#这类强类型语言转战Godot的第一次看到Array这个类型可能会觉得它平平无奇不就是个动态数组嘛。但如果你真这么想那可就错过了Godot引擎里这把最趁手的“瑞士军刀”。在Godot里Array远不止是一个简单的数据容器它融合了列表、栈、队列、集合去重、映射键值对查找等多种数据结构的核心操作并且通过一套极其简洁、统一的API暴露给你。我刚开始用Godot时也习惯性地去定义各种结构体struct或者用Dictionary来管理复杂数据直到有一次为了优化一段物品管理代码我仔细对比了Array和Dictionary在纯遍历和查找上的性能并深入阅读了部分源码才发现Array在Godot内部的优化程度非常高。对于顺序访问、尾部增删这类操作它的效率非常可观。更重要的是它的typed array类型化数组在4.0之后得到了极大增强让你在享受动态类型便利的同时也能在需要时获得近乎静态类型的安全性和性能。简单来说Godot的Array是一个动态的、可包含任意类型Variant的、内置了丰富高阶方法的集合类。它解决了游戏开发中那些高频但琐碎的数据操作需求比如快速过滤出所有攻击力大于50的武器、对一批敌人按距离排序、或是高效地合并和去重多个掉落物品列表。本文将带你彻底拆解Godot 4.2中Array的每一个核心特性和使用技巧让你能像使用自己的手脚一样熟练地运用它。2. 创建与初始化不止是[]那么简单创建一个Array最直观的方式就是使用字面量[]。但根据不同的使用场景Godot提供了多种初始化方式选择合适的一种能让代码意图更清晰有时甚至能提升性能。2.1 基础创建与字面量最常用的就是直接赋值var my_array [] # 创建一个空数组 var numbers [1, 2, 3, 4, 5] # 创建并初始化一个整数数组 var mixed [1, hello, true, Vector2(1, 2)] # Godot数组可以混合存放任何类型这种混合类型的能力是Array灵活性的基础但也可能是bug的温床我们后面会讲到如何用类型化数组来约束它。2.2 使用Array()构造方法Array构造方法接受一个可选参数用于从其他可迭代对象创建数组。这在转换数据时非常有用。var str Hello var char_array Array(str) # 结果为 [H, e, l, l, o] 将字符串拆分为字符数组 var dict {a: 1, b: 2} var keys_array Array(dict) # 注意结果不是[{a:1}, {b:2}]而是[a, b]。这里迭代的是字典的键。 # 如果想得到键值对数组通常使用 dict.keys() 和 dict.values()或者用 map 方法。这里有一个非常重要的坑需要提醒直接使用Array(dictionary)得到的并不是包含键值对对象的数组而是由字典的键keys组成的数组。这个行为与遍历字典for key in dict:的行为一致但如果你预期的是键值对就会出错。正确的做法是var dict {a: 1, b: 2} # 方法1分别获取键和值 var keys dict.keys() var values dict.values() # 方法2使用map生成键值对数组例如元组数组 var pairs dict.keys().map(func(key): return [key, dict[key]])2.3 类型化数组兼顾灵活与安全这是Godot 4.x版本中一个至关重要的特性。你可以为数组声明其允许存储的元素类型从而获得编辑器代码补全、静态类型检查和潜在的性能优化。# 语法 Array[Type] var ints: Array[int] [1, 2, 3] var strings: Array[String] [a, b, c] var nodes: Array[Node] [$Sprite2D, $Player] # 尝试放入错误类型会在编辑器中和运行时取决于设置报错 ints.append(hello) # 错误无法将String赋值给Array[int]中的元素 # 类型化数组也支持复杂的嵌套和自定义资源类型 var array_of_arrays: Array[Array] [[1,2], [3,4]] var inventory: Array[InventorySlot] [] # 假设InventorySlot是一个自定义Resource为什么推荐使用类型化数组代码清晰与安全它作为文档明确了数组的用途编译器能提前阻止类型错误。编辑器支持在VS Code或Godot内置编辑器中对类型化数组进行遍历或访问元素时能获得正确的类型提示和自动补全。性能虽然Godot内部Array始终存储Variant但明确的类型信息有时能让引擎生成更优化的代码尤其是在AOT编译如GDExtension场景下。2.4 工厂方法Array.makeArray.make用于快速创建一个填充了默认值的数组。这在需要预定长度的数组时非常方便比如一个固定大小的环形缓冲区。# Array.make(value: Variant, count: int) - Array var zeroes Array.make(0, 10) # 创建包含10个0的数组[0, 0, 0, ...] var nulls Array.make(null, 5) # 创建包含5个null的数组 var vectors Array.make(Vector2.ZERO, 8) # 创建包含8个Vector2.ZERO的数组需要注意的是Array.make创建的是浅拷贝。如果value是引用类型如Array,Dictionary, 自定义Resource那么数组中的所有元素都是对同一个对象的引用。修改其中一个会影响所有。var inner [1, 2] var array_of_arrays Array.make(inner, 3) # array_of_arrays 现在是 [[1,2], [1,2], [1,2]] array_of_arrays[0].append(3) # 现在 array_of_arrays 变成了 [[1,2,3], [1,2,3], [1,2,3]] 因为三个元素引用的是同一个列表对象。3. 核心操作增删改查的哲学Array的核心操作API设计得非常直观但其中一些方法的细节和性能特征需要了然于胸。3.1 增append,push_back,insertappend(value)/push_back(value)在数组末尾添加一个元素。这是时间复杂度为O(1)摊销的操作是最快的添加方式。var arr [1, 2] arr.append(3) # arr 变为 [1, 2, 3] arr.push_back(4) # arr 变为 [1, 2, 3, 4] (append的别名)insert(position: int, value: Variant)在指定索引处插入一个元素。这是一个O(n)的操作因为插入点之后的所有元素都需要向后移动一位。在循环中频繁使用insert(0, value)在头部插入是性能陷阱。var arr [b, c] arr.insert(0, a) # 在头部插入arr 变为 [a, b, c] arr.insert(2, d) # 在索引2处插入arr 变为 [a, b, d, c]实操心得如果你需要维持一个顺序列表并且频繁地在两端添加元素考虑使用append尾部并结合一个索引来模拟头部操作或者评估是否LinkedListGodot没有内置需自己实现更合适。对于大多数游戏开发场景如管理 spawned enemies, collected itemsappend足以应对。3.2 删pop_at,pop_back,pop_front,remove_at,clearpop_at(position: int)移除并返回指定索引处的元素。这也是一个O(n)操作。pop_back()移除并返回最后一个元素。O(1)。pop_front()移除并返回第一个元素。O(n)因为需要移动所有剩余元素。remove_at(position: int)移除指定索引处的元素不返回。O(n)。clear()清空数组移除所有元素。O(n)因为要释放每个元素但通常很快。var arr [a, b, c, d, e] var last arr.pop_back() # last e, arr [a, b, c, d] var first arr.pop_front() # first a, arr [b, c, d] var middle arr.pop_at(1) # middle c, arr [b, d] arr.remove_at(0) # arr [d] arr.clear() # arr []性能警告pop_front()和remove_at(0)在长数组上频繁调用会是性能瓶颈。如果你需要“先进先出”FIFO的队列行为考虑使用append配合一个pop_front但要注意性能。对于高性能要求的队列更好的模式是使用append并维护一个“头指针”索引避免实际的数据移动。3.3 改直接索引赋值修改数组元素最简单直接。var arr [10, 20, 30] arr[0] 100 # arr [100, 20, 30] arr[-1] 300 # 支持负索引-1表示最后一个元素。arr [100, 20, 300]注意边界尝试访问或赋值超出数组范围的索引如arr[10]会导致运行时错误。务必确保索引有效。3.4 查索引、find、has、count索引访问arr[index] O(1)。find(what: Variant, from: int 0) - int从from索引开始查找第一个匹配what的元素的索引找不到则返回-1。这是一个O(n)的线性搜索。var arr [apple, banana, cherry, banana] var idx arr.find(banana) # idx 1 idx arr.find(banana, 2) # 从索引2开始找 idx 3 idx arr.find(durian) # idx -1rfind(what: Variant, from: int -1) - int反向查找。has(value: Variant) - bool检查数组是否包含某个值。内部就是调用find() ! -1。O(n)。count(value: Variant) - int计算某个值在数组中出现的次数。O(n)。var arr [1, 2, 2, 3, 2] var has_two arr.has(2) # true var num_twos arr.count(2) # 3重要提醒find、has、count都是线性搜索。如果你的数组很大比如上千个元素并且需要频繁进行存在性检查或计数使用Array可能不是最优解。考虑使用Dictionary键值对或SetGodot 4.1 引入基于Dictionary来获得O(1)的查找性能。例如如果你只关心某个ID是否存在用一个Dictionary来记录ID - true会比在Array里反复find快得多。4. 迭代与遍历多种姿势各取所需遍历数组是日常操作Godot提供了多种方式。4.1for循环最通用var fruits [Apple, Banana, Orange] for i in range(fruits.size()): print(Index %d: %s % [i, fruits[i]]) # 需要索引时用这个4.2for-in循环最简洁不需要索引时for fruit in fruits: print(fruit) # 直接获取元素4.3for-in带索引使用enumerate类似Python这是我最推荐的方式结合了简洁和索引信息。for index in fruits.size(): var fruit fruits[index] print(Index %d: %s % [index, fruit]) # 或者如果你喜欢更函数式的风格Godot 4.0 for i in fruits.size(): print(Index %d: %s % [i, fruits[i]])注意Godot的for index in array.size()是一种习惯用法array.size()返回的是整数范围。4.4while循环更灵活的控制当你需要在遍历中根据条件动态改变索引时比如跳过某些元素while循环更合适。var i 0 while i arr.size(): if some_condition(arr[i]): i 2 # 跳过下一个元素 else: process(arr[i]) i 15. 高阶函数让代码更声明式Godot 4.0为Array引入了类似JavaScript/Python的函数式编程方法这极大地提升了代码的表达能力。这些方法通常返回一个新数组不会修改原数组除非特别说明。5.1map(callable: Callable) - Array将数组中的每个元素通过一个函数进行转换返回由结果组成的新数组。var numbers [1, 2, 3, 4] var squares numbers.map(func(x): return x * x) # [1, 4, 9, 16] # 假设有一个Node数组 var enemies: Array[Node2D] get_tree().get_nodes_in_group(enemies) var enemy_positions enemies.map(func(enemy: Node2D): return enemy.global_position)map是数据转换的利器能避免显式的循环让意图更清晰。5.2filter(callable: Callable) - Array过滤出数组中满足条件的元素。var numbers [1, 2, 3, 4, 5, 6] var evens numbers.filter(func(x): return x % 2 0) # [2, 4, 6] # 过滤出还活着的敌人 var alive_enemies enemies.filter(func(enemy): return enemy.health 0)5.3reduce(callable: Callable, initial) - Variant将数组中的所有元素通过一个函数累积计算为一个单一的值。这是理解起来稍复杂但功能强大的函数。var numbers [1, 2, 3, 4] var sum numbers.reduce(func(accum, number): return accum number, 0) # 10 # 执行过程 (( (01) 2 ) 3 ) 4 # 找出最大血量 var max_health enemies.reduce(func(max_hp, enemy): return maxf(max_hp, enemy.health), 0.0)reduce的第一个参数是累积回调函数它接收两个参数当前的累积值和当前数组元素。第二个参数是累积的初始值。5.4any(callable: Callable) - bool/all(callable: Callable) - boolany: 判断数组中是否至少有一个元素满足条件。all: 判断数组中是否所有元素都满足条件。var has_any_dead enemies.any(func(enemy): return enemy.health 0) var all_alive enemies.all(func(enemy): return enemy.health 0)这两个函数在判断集合整体状态时非常方便避免了手动写循环和标志变量。5.5sort_custom(callable: Callable)/sorted(callable: Callable) - Array自定义排序。sort_custom会修改原数组而sorted返回排序后的新数组。 回调函数接受两个参数a和b如果希望a排在b前面则返回true。var players [...] # 假设是Player对象的数组 # 按分数降序排序 players.sort_custom(func(a, b): return a.score b.score) # 按距离玩家的升序排序 var player_pos $Player.global_position enemies.sort_custom(func(a, b): var dist_a a.global_position.distance_squared_to(player_pos) var dist_b b.global_position.distance_squared_to(player_pos) return dist_a dist_b # 距离小的排前面 )性能提示对于简单类型如整数、字符串的排序使用内置的sort()方法无参数性能更高因为它使用引擎内部优化过的比较逻辑。sort_custom由于需要频繁调用GDScript回调函数在排序大数组时会有额外开销。6. 实用工具方法去重、洗牌、切片与合并6.1 去重make_unique()make_unique()会原地修改数组移除所有重复的、相邻的元素只保留第一个。注意关键词“相邻”。这意味着它不会对数组进行全局去重除非数组已经排序。var arr1 [1, 2, 2, 3, 3, 3, 2, 1] arr1.make_unique() # arr1 变为 [1, 2, 3, 2, 1] (只去除了相邻的重复) var arr2 [1, 3, 2, 3, 1] arr2.make_unique() # arr2 不变因为重复的3和1都不相邻 # 要实现全局去重通常先排序 var arr3 [1, 3, 2, 3, 1] arr3.sort() arr3.make_unique() # arr3 变为 [1, 2, 3]如果你需要不改变顺序的全局去重一个常见的模式是使用Dictionary的键唯一性var arr [1, 3, 2, 3, 1] var dict {} for item in arr: dict[item] true var unique_arr dict.keys() # 注意keys()的顺序是插入顺序在Godot 3.x以后是稳定的所以这里能得到[1, 3, 2]6.2 洗牌shuffle()随机打乱数组元素的顺序。常用于抽奖、随机出敌等场景。var cards [A, K, Q, J, 10] cards.shuffle() # cards 现在是一个随机顺序例如 [Q, A, 10, J, K]6.3 切片slice(begin: int, end: int 2147483647, step: int 1, deep: bool false) - Array提取数组的一部分返回一个新数组。参数begin是起始索引包含end是结束索引不包含step是步长deep决定是否对引用类型元素进行深拷贝。var arr [0, 1, 2, 3, 4, 5, 6] var part1 arr.slice(2) # 从索引2到最后: [2, 3, 4, 5, 6] var part2 arr.slice(1, 5) # 索引1到4: [1, 2, 3, 4] var part3 arr.slice(0, 7, 2)# 从0到6步长为2: [0, 2, 4, 6] var reversed arr.slice(6, -1, -1) # 从6到开始步长-1: [6, 5, 4, 3, 2, 1, 0] (手动反转)关于deep参数默认是false即浅拷贝。如果数组元素是Array或Dictionary等新数组和原数组的元素指向同一个对象。如果设置为trueGodot会尝试递归地复制这些元素对于Resource这通常是深拷贝但对于Object如Node行为可能复杂通常不推荐对包含节点的数组进行深拷贝切片。6.4 合并操作符与append_array操作符连接两个数组返回一个新数组。var a [1, 2] var b [3, 4] var c a b # c [1, 2, 3, 4], a和b不变append_array(array: Array)将另一个数组的所有元素追加到当前数组的末尾。原地修改。var a [1, 2] var b [3, 4] a.append_array(b) # a 变为 [1, 2, 3, 4], b不变选择哪个取决于你是否需要保留原数组。append_array通常更高效因为它避免了创建新数组的开销。7. 性能考量与最佳实践在游戏开发中数据结构的性能至关重要。以下是一些关于Array性能的硬核知识和实践建议。7.1 理解时间复杂度O(1) (常数时间)通过索引访问(arr[i])、尾部追加(append/push_back)、尾部弹出(pop_back)、获取大小(size())。O(n) (线性时间)查找(find,has,count)、插入/删除非尾部元素(insert,pop_at,pop_front,remove_at)、包含回调的高阶函数(map,filter,sort_custom等因为它们至少需要遍历一次)。O(n log n)排序(sort())。黄金法则避免在循环内部对大型数组进行O(n)操作这会导致O(n²)的灾难性性能。例如不要在每一帧都find一个包含上千个元素的数组。7.2 预分配与内存Godot的Array是动态数组内部会预留一些额外容量capacity以避免每次append都重新分配内存。你可以通过resize()方法来手动调整大小但这通常不是必需的因为引擎的自动管理已经很好。resize()更大的尺寸会预分配内存resize()更小会释放多余内存并截断数组。var arr [] arr.resize(1000) # 预分配1000个元素的空间所有元素初始化为null arr[999] end # 可以直接访问 arr.resize(500) # 截断索引500-999的元素丢失对于已知最大大小的批量操作比如从文件加载1000个配置项预分配可以避免多次扩容带来的微小开销。但对于大多数情况相信append的摊销O(1)性能即可。7.3ArrayvsDictionaryvsPacked*ArrayArray擅长顺序访问和遍历。当你需要保持元素的插入顺序或者需要频繁按索引随机访问时用Array。Dictionary擅长按键快速查找(O(1))。当你需要通过一个唯一的键如字符串ID、整数ID来查找、插入、删除数据时用Dictionary。它不保证顺序虽然Godot 3.x后默认按插入顺序迭代。PackedByteArray、PackedInt32Array等这些是紧密打包的、类型单一的数组。它们的内存效率极高因为所有元素连续存储没有每个元素的Variant开销。用于存储大量同类型的简单数据如网格顶点、图像数据、网络数据包时性能远超普通Array。但它们只能存储基本类型整数、浮点数、字节等API也更基础。选择建议管理游戏实体列表如所有敌人、所有子弹用Array[Node2D]。通过ID快速查找物品属性如iron_sword - {damage: 10}用Dictionary。处理从网络接收的二进制协议数据用PackedByteArray。7.4 一个实战案例对象池的实现对象池是重用游戏对象如子弹、特效以减轻GC压力的经典模式。Array是实现简单对象池的绝佳选择。extends Node2D class_name BulletPool export var bullet_scene: PackedScene export var initial_pool_size: int 20 var _pool: Array[Node2D] [] var _available: Array[Node2D] [] func _ready(): # 预初始化对象池 for i in range(initial_pool_size): var bullet bullet_scene.instantiate() as Node2D bullet.visible false bullet.process_mode Node.PROCESS_MODE_DISABLED # 禁用物理处理 add_child(bullet) _pool.append(bullet) _available.append(bullet) # 可用列表 func get_bullet() - Node2D: if _available.is_empty(): # 池已空动态扩容或返回null取决于设计 var new_bullet bullet_scene.instantiate() as Node2D add_child(new_bullet) _pool.append(new_bullet) return new_bullet else: # 从可用列表尾部取出O(1) var bullet _available.pop_back() bullet.visible true bullet.process_mode Node.PROCESS_MODE_INHERIT return bullet func return_bullet(bullet: Node2D): if bullet in _pool: bullet.visible false bullet.process_mode Node.PROCESS_MODE_DISABLED bullet.global_position Vector2.ZERO # 重置状态 # 放回可用列表尾部O(1) if not bullet in _available: _available.append(bullet)在这个实现中我们用了两个Array_pool记录所有子弹实例_available作为一个栈后进先出来管理可用子弹。pop_back()和append()都是O(1)操作使得获取和归还子弹非常高效。同时类型化数组Array[Node2D]确保了类型安全。8. 常见陷阱与调试技巧即使是最简单的工具用不好也会踩坑。下面是一些我亲身经历或见别人踩过的Array相关的坑。8.1 浅拷贝与深拷贝这是引用类型语言中的经典问题。Array的赋值和参数传递是浅拷贝。var a [ [1, 2], [3, 4] ] # 二维数组 var b a.duplicate() # 默认是浅拷贝 b[0].append(99) print(a) # 输出 [[1, 2, 99], [3, 4]]因为a[0]和b[0]引用同一个内部数组 # 正确的深拷贝 var c a.duplicate(true) # 参数 deeptrue c[0].append(100) print(a) # 输出 [[1, 2, 99], [3, 4]] 不变 print(c) # 输出 [[1, 2, 99, 100], [3, 4]]duplicate(deep: bool false)方法用于复制数组。默认浅拷贝只复制数组结构本身内部的引用类型对象仍是共享的。深拷贝会递归复制所有元素但对于Node等复杂对象深拷贝可能不可行或不是你想要的行为。8.2 在迭代中修改数组绝对不要在for-in或for i in array.size()循环中直接添加或删除元素这会导致未定义行为很可能崩溃或跳过元素。# 错误示范 var arr [1, 2, 3, 4, 5] for num in arr: if num % 2 0: arr.erase(num) # 在迭代中删除危险 # 正确做法1先收集要处理的元素循环结束后再操作 var to_remove [] for num in arr: if num % 2 0: to_remove.append(num) for num in to_remove: arr.erase(num) # 正确做法2从后向前遍历索引适用于删除 for i in range(arr.size() - 1, -1, -1): if arr[i] % 2 0: arr.remove_at(i) # 从后往前删索引不会错乱 # 正确做法3使用 filter 高阶函数最简洁 arr arr.filter(func(x): return x % 2 ! 0)8.3 负索引与越界Godot支持负索引-1表示最后一个元素-2表示倒数第二个以此类推。这很方便但要小心计算。var arr [10, 20, 30] print(arr[-1]) # 30 print(arr[-3]) # 10 # print(arr[-4]) # 错误越界确保你的索引在-arr.size() index arr.size()范围内。8.4 类型化数组的运行时检查即使你声明了Array[int]在非严格类型检查模式下Godot编辑器默认错误的类型赋值在运行时可能不会立即报错但会导致后续难以调试的问题。建议在项目设置中开启“严格类型检查”或者在可能出问题的地方手动断言。var ints: Array[int] [1, 2, 3] ints.append(oops) # 在非严格模式下可能不会报错但破坏了类型约定 # 好的做法 if typeof(new_value) TYPE_INT: ints.append(new_value) else: push_error(Tried to append non-int to typed array.)8.5 使用调试工具print(arr)或printt(arr)快速打印整个数组。在编辑器的调试器“远程”视图中可以展开查看数组的每个元素对于复杂对象非常有用。使用assert进行防御性编程var index some_function() assert(index 0 and index my_array.size(), Index out of bounds!) var element my_array[index]Godot的Array是一个设计精良、功能丰富的工具。从简单的数据存储到复杂的数据转换再到高性能的游戏模式它都能胜任。理解其特性、性能边界和最佳实践能让你在Godot开发中更加游刃有余。记住没有最好的数据结构只有最合适的数据结构。Array是你的瑞士军刀但知道何时该换成专门的斧头Dictionary或锯子PackedArray才是资深开发者的标志。