effect · clear_array

实战用法

clear_array 常用于需要在每次事件触发或循环迭代前重置动态数组内容的场景，例如在 AI 决策逻辑或动态列表构建中，先清空旧数据再重新填充，避免数组内容累积产生错误结果。典型场景是每月脉冲事件中重新统计符合条件的国家列表。

# 每次事件触发时，先清空旧的候选国家数组，再重新填充
immediate = {
    clear_array = candidate_countries
    every_country = {
        limit = { is_major = yes }
        add_to_array = { array = candidate_countries value = THIS }
    }
}

配合关系

• [add_to_array](/wiki/effect/add_to_array)：清空数组后紧接着用其重新填充元素，是最典型的"重置并重建"组合。
• [resize_array](/wiki/effect/resize_array)：若需要清空并同时预分配固定长度，可在 clear_array 后用 resize_array 初始化占位值。
• [for_each_scope_loop](/wiki/effect/for_each_scope_loop)：遍历数组元素前先用 clear_array 确保数组干净，避免历史残留数据干扰循环逻辑。
• [is_in_array](/wiki/trigger/is_in_array)：配合使用时，clear_array 保证每轮检查前数组状态可预期，使该触发器的判断结果准确可靠。

常见坑

1. 误用于临时数组应改用 clear_temp_array：clear_array 操作的是持久化数组（保存在存档中），若只需要在单次事件内临时使用的数组应使用 [clear_temp_array](/wiki/effect/clear_temp_array)，否则会造成不必要的存档膨胀甚至数据污染。
2. 清空不存在的数组不会报错但也无效：如果数组名拼写错误或尚未初始化，游戏不会给出任何提示，后续 add_to_array 填充看似正常，却可能在其他地方引用了同名但大小写不一致的"另一个"数组，导致难以排查的逻辑错误。