godot-performance-optimization

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Performance Optimization

性能优化

Profiler-driven analysis, object pooling, and visibility culling define optimized game performance.

基于Profiler的分析、对象池和可见性剔除是实现游戏性能优化的核心方法。

Available Scripts

可用脚本

custom_performance_monitor.gd

Manager for adding and updating custom performance monitors in the Godot debugger.

用于在Godot调试器中添加和更新自定义性能监视器的管理脚本。

multimesh_foliage_manager.gd

Expert MultiMesh pattern for rendering thousands of foliage instances efficiently.

使用MultiMesh模式高效渲染数千个植被实例的实现方案。

NEVER Do in Performance Optimization

性能优化的禁忌

NEVER optimize without profiling first — "I think physics is slow" without data? Premature optimization. ALWAYS use Debug → Profiler (F3) to identify actual bottleneck.
NEVER use
print()
in release builds —
```
print()
```
every frame = file I/O bottleneck + log spam. Use
```
@warning_ignore
```
or conditional
```
if OS.is_debug_build():
```
.
NEVER ignore
VisibleOnScreenNotifier2D
for off-screen entities — Enemies processing logic off-screen = wasted CPU. Disable
```
set_process(false)
```
when
```
screen_exited
```
.
NEVER instantiate nodes in hot loops —
```
for i in 1000: var bullet = Bullet.new()
```
= 1000 allocations. Use object pools, reuse instances.

NEVER use
get_node()
in
_process()
— Calling

get_node("Player")

60x/sec = tree traversal spam. Cache in

@onready var player := $Player

NEVER forget to batch draw calls — 1000 unique sprites = 1000 draw calls. Use TextureAtlas (sprite sheets) + MultiMesh for instanced rendering.

Debug → Profiler (F3)

Tabs:

Time: Function call times
Memory: RAM usage
Network: RPCs, bandwidth
Physics: Collision checks

绝对不要在未分析前就优化 —— 没有数据支撑就说“我觉得物理模块很慢”属于过早优化。务必使用Debug → Profiler（F3）来定位实际的性能瓶颈。
绝对不要在发布版本中使用
print()
—— 每帧调用
```
print()
```
会导致文件I/O瓶颈和日志泛滥。请使用
```
@warning_ignore
```
或条件判断
```
if OS.is_debug_build():
```
来控制。
绝对不要忽略对屏幕外实体使用
VisibleOnScreenNotifier2D
—— 屏幕外的敌人仍在运行逻辑会浪费CPU资源。当触发
```
screen_exited
```
信号时，调用
```
set_process(false)
```
禁用其处理流程。
绝对不要在热循环中实例化节点 ——
```
for i in 1000: var bullet = Bullet.new()
```
会产生1000次内存分配。请使用对象池，复用实例。
绝对不要在
_process()
中调用
get_node()
—— 每秒调用60次
```
get_node("Player")
```
会频繁遍历节点树。请在
```
@onready var player := $Player
```
中缓存节点引用。
绝对不要忘记批量处理绘制调用 —— 1000个独立精灵会产生1000次绘制调用。请使用TextureAtlas（精灵图集）+ MultiMesh进行实例化渲染。

Debug → Profiler（F3）

标签页：

Time：函数调用耗时
Memory：内存使用情况
Network：RPC调用、带宽占用
Physics：碰撞检测情况

Common Optimizations

常见优化方案

Object Pooling

对象池

gdscript

var bullet_pool: Array[Node] = []

func get_bullet() -> Node:
    if bullet_pool.is_empty():
        return Bullet.new()
    return bullet_pool.pop_back()

func return_bullet(bullet: Node) -> void:
    bullet.hide()
    bullet_pool.append(bullet)

gdscript

var bullet_pool: Array[Node] = []

func get_bullet() -> Node:
    if bullet_pool.is_empty():
        return Bullet.new()
    return bullet_pool.pop_back()

func return_bullet(bullet: Node) -> void:
    bullet.hide()
    bullet_pool.append(bullet)

Visibility Notifier

可见性通知器

gdscript

undefined

gdscript

undefined

Add VisibleOnScreenNotifier2D

添加VisibleOnScreenNotifier2D

Disable processing when off-screen

当实体离开屏幕时禁用处理流程

func _on_screen_exited() -> void: set_process(false)

func _on_screen_entered() -> void: set_process(true)

undefined

func _on_screen_exited() -> void: set_process(false)

func _on_screen_entered() -> void: set_process(true)

undefined

Reduce Draw Calls

减少绘制调用

undefined

undefined

Use TextureAtlas (sprite sheets)

使用TextureAtlas（精灵图集）

Batch similar materials

批量处理相似材质

Fewer unique textures

减少唯一纹理的数量

undefined

undefined

Reference

参考资料

Godot Docs: Performance Optimization

Godot官方文档：性能优化

godot-performance-optimization

Original

Translation

Performance Optimization

性能优化

Available Scripts

可用脚本

custom_performance_monitor.gd

custom_performance_monitor.gd

multimesh_foliage_manager.gd

multimesh_foliage_manager.gd

NEVER Do in Performance Optimization

性能优化的禁忌

Common Optimizations

常见优化方案

Object Pooling

对象池

Visibility Notifier

可见性通知器

Add VisibleOnScreenNotifier2D

添加VisibleOnScreenNotifier2D

Disable processing when off-screen

当实体离开屏幕时禁用处理流程

Reduce Draw Calls

减少绘制调用

Use TextureAtlas (sprite sheets)

使用TextureAtlas（精灵图集）

Batch similar materials

批量处理相似材质

Fewer unique textures

减少唯一纹理的数量

Reference

参考资料

Related

相关内容