【 Godot 4 学习笔记】数组（Array）

在 Godot 4 的 GDScript 中，数组（Array）是最常用、最基础的容器之一，用来存储一系列有序的数据。你可以把它想象成一个可以随意伸缩的"储物柜"，里面可以放各种类型的物品。

以下是 Godot 4 中数组的完整使用指南：

📦 数组的创建与初始化

数组用方括号 [] 定义，元素之间用逗号 , 分隔。

# 1. 创建一个空数组
var my_array = []

# 2. 创建并初始化数组（可以混合存放不同类型的数据）
var inventory = ["宝剑", 50, true, Vector2(10, 20)]

# 3. 静态类型数组（强烈推荐）
# 限制数组只能存放特定类型的数据，能有效避免代码逻辑错误
var scores: Array[int] = 
var names: Array[String] = ["Alice", "Bob"]

🛠️ 常用操作方法

Godot 提供了丰富的内置方法来增删改查数组元素：

方法	说明	示例
append(value)	在数组末尾添加一个元素	arr.append(4)
append_array(array)	将另一个数组的所有元素拼接到当前数组末尾	arr.append_array()
insert(index, value)	在指定索引位置插入一个元素	arr.insert(1, "新元素")
remove_at(index)	删除指定索引位置的元素	arr.remove_at(0)
erase(value)	删除数组中第一个匹配到的指定值	arr.erase("宝剑")
pop_front() / pop_back()	删除并返回数组第一个/最后一个元素	var last = arr.pop_back()
has(value)	检查数组中是否包含某个值	if arr.has(10):
find(value)	返回某个值第一次出现的索引（找不到返回 -1）	var index = arr.find(20)
size()	获取数组的长度（元素个数）	print(arr.size())
clear()	清空数组中的所有元素	arr.clear()

🔍 访问与修改元素

数组是从 0 开始索引的。你可以像访问普通变量一样读取或修改指定位置的元素。

var fruits = ["苹果", "香蕉", "橘子"]

# 访问元素
print(fruits)  # 输出: 苹果
print(fruits)  # 输出: 橘子[[source_group_web_2]]

# 修改元素
fruits = "葡萄" 
print(fruits)     # 输出: ["苹果", "葡萄", "橘子"][[source_group_web_3]]

# 负数索引（从后往前数）
print(fruits[-1]) # 输出: 橘子 (最后一个元素)
print(fruits[-2]) # 输出: 葡萄 (倒数第二个元素)

🔄 遍历数组

遍历数组主要有两种常用方式：

1. 直接遍历元素（最常用）：

for fruit in fruits:
    print("水果:", fruit)

2. 通过索引遍历：

for i in range(fruits.size()):
    print("索引:", i, "元素:", fruits[i])

⚠️ 核心避坑指南：引用传递

这是新手最容易踩的坑！在 Godot 中，数组是引用类型。当你把一个数组赋值给另一个变量时，它们其实指向的是内存中的同一个数组。

var array_a = 
var array_b = array_a  # 只是复制了引用，没有创建新数组[[source_group_web_4]]

array_b.append(4)      # 修改 array_b
print(array_a)         # 输出:  -> array_a 也被改变了！

解决方案： 如果你需要一个完全独立的副本，必须使用 duplicate() 方法。

var array_c = array_a.duplicate() # 创建一个真正的副本
array_c.append(5)
print(array_a) # 输出:  -> array_a 不受影响

🚀 进阶：数组的其他实用技巧

• 排序与打乱 ：

  var nums = 
  nums.sort()      # 升序排列 -> 
  nums.shuffle()   # 随机打乱顺序

• 切片（截取子数组） ：

  var arr = 
  var sub = arr.slice(1, 4) # 截取索引 1 到 3 的元素 -> 

• 紧缩数组（Packed Arrays） ：
  如果你需要处理大量单一类型的数据（比如成千上万个坐标点或颜色值），可以使用 Godot 提供的 Packed 系列数组（如 PackedInt32Array, PackedVector2Array 等）。它们比普通数组占用更少的内存，性能更高。

掌握这些基础操作，你就能在 Godot 中灵活地运用数组来处理各种游戏数据了！