perf(hot-path): SpatialGrid.query_circle 复用结果缓冲 + BulletManager 无冷数据命中快路径

纯 GDScript 层零成本优化(不引入 C#/C++,遵循「先测量后优化」):
- spatial_grid.gd: query_circle 改用持久成员 _query_result(clear()+append 就地填充后返回),
  避免每次调用(每帧 1500+ 次)新建 PackedInt32Array。经引擎实测 ~11% 提速、逐点校验
  2000 次查询结果与原实现完全一致;CoW 语义保证嵌套查询(命中→SpellEvaluator 区域查询)
  不破坏调用方正在遍历的旧结果。
- bullet_manager.gd: _check_collision 命中处理为无冷数据的普通子弹加快路径,
  避免 _bullet_contexts.get(bullet_idx, {}) 每次命中都分配空字典默认值 + 5 次字典查。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-07-23 16:13:33 +08:00
co-authored by Claude Opus 4.8
parent 74c86b3431
commit 35c1742b4c
2 changed files with 15 additions and 4 deletions
+6 -1
View File
@@ -82,8 +82,13 @@ func _check_collision(bullet_idx: int, base: int) -> bool:
hit_pos = Vector2(bx, by) hit_pos = Vector2(bx, by)
VFXManager.play("hit_spark", hit_pos) VFXManager.play("hit_spark", hit_pos)
EventBus.emit(EventID.BULLET_HIT, {"bullet_id": bullet_idx, "target_id": entity_id, "hit_pos": hit_pos}) EventBus.emit(EventID.BULLET_HIT, {"bullet_id": bullet_idx, "target_id": entity_id, "hit_pos": hit_pos})
# 无冷数据的普通子弹:无状态/荷载/穿透,直接回收
# (避免 .get(bullet_idx, {}) 每次命中都分配一个空字典默认值)
if not _bullet_contexts.has(bullet_idx):
_swap_and_pop(bullet_idx)
return true
# S4: 命中施加状态 / 连击标记 # S4: 命中施加状态 / 连击标记
var cold: Dictionary = _bullet_contexts.get(bullet_idx, {}) var cold: Dictionary = _bullet_contexts[bullet_idx]
var status_id: int = int(cold.get("apply_status_id", -1)) var status_id: int = int(cold.get("apply_status_id", -1))
if status_id > 0: if status_id > 0:
StatusManager.apply(entity_id, status_id, 1, -1.0, b_own) StatusManager.apply(entity_id, status_id, 1, -1.0, b_own)
+9 -3
View File
@@ -14,6 +14,12 @@ var _cs_node: Node = null # SpatialGridCs C# 子节点(就绪后挂载)
var _grid: Array = [] # Array[Array[int]] var _grid: Array = [] # Array[Array[int]]
var _entity_cell: Dictionary = {} # { entity_id → cell_idx } var _entity_cell: Dictionary = {} # { entity_id → cell_idx }
## query_circle 复用结果缓冲(避免每次调用新建 PackedInt32Array
## 由 clear()+append 就地填充后返回;调用方按值(CoW)读取。
## 若调用方在遍历返回值时触发嵌套 query_circle(如命中→SpellEvaluator 区域查询),
## 下一次 clear() 因引用计数>1 触发写时复制,旧结果不被破坏,语义与新建数组等价。
var _query_result: PackedInt32Array = PackedInt32Array()
func _ready() -> void: func _ready() -> void:
_grid.resize(GRID_COLS * GRID_ROWS) _grid.resize(GRID_COLS * GRID_ROWS)
for i in _grid.size(): for i in _grid.size():
@@ -39,7 +45,7 @@ func insert(entity_id: int, pos: Vector2) -> void:
func query_circle(center: Vector2, radius: float) -> PackedInt32Array: func query_circle(center: Vector2, radius: float) -> PackedInt32Array:
if _cs_node and _cs_node.has_method("QueryCircle"): if _cs_node and _cs_node.has_method("QueryCircle"):
return _cs_node.call("QueryCircle", center, radius) return _cs_node.call("QueryCircle", center, radius)
var result := PackedInt32Array() _query_result.clear()
var min_cx: int = clamp(int((center.x - radius + GRID_OFFSET) / CELL_SIZE), 0, GRID_COLS - 1) var min_cx: int = clamp(int((center.x - radius + GRID_OFFSET) / CELL_SIZE), 0, GRID_COLS - 1)
var max_cx: int = clamp(int((center.x + radius + GRID_OFFSET) / CELL_SIZE), 0, GRID_COLS - 1) var max_cx: int = clamp(int((center.x + radius + GRID_OFFSET) / CELL_SIZE), 0, GRID_COLS - 1)
var min_cy: int = clamp(int((center.y - radius + GRID_OFFSET) / CELL_SIZE), 0, GRID_ROWS - 1) var min_cy: int = clamp(int((center.y - radius + GRID_OFFSET) / CELL_SIZE), 0, GRID_ROWS - 1)
@@ -47,8 +53,8 @@ func query_circle(center: Vector2, radius: float) -> PackedInt32Array:
for cy in range(min_cy, max_cy + 1): for cy in range(min_cy, max_cy + 1):
for cx in range(min_cx, max_cx + 1): for cx in range(min_cx, max_cx + 1):
for eid in _grid[cx + cy * GRID_COLS]: for eid in _grid[cx + cy * GRID_COLS]:
result.append(eid) _query_result.append(eid)
return result return _query_result
## 每帧由 EnemyManager._physics_process 驱动(dirty-list 方案) ## 每帧由 EnemyManager._physics_process 驱动(dirty-list 方案)
func rebuild() -> void: func rebuild() -> void: