GDScript中while循环内print语句仅循环结束后批量输出问题咨询

在extends TileMap的脚本方法中编写如下隧道生成循环代码时：

while tunnels_carved < num_tunnels:
    # 隧道生成逻辑
    .
    .
    tunnels_carved += 1
    print("Generation at ", round(tunnels_carved / num_tunnels * 100), "%")

会出现如下现象：

• 循环运行过程中，Godot编辑器控制台不会实时输出print内容，所有日志会在整个while循环执行完毕后一次性全部显示
• 如果循环执行时触发断点，print会按预期逐次输出
• 相同的日志内容可以在操作系统终端窗口按执行时机实时输出，可满足基础调试需求
  需要实现Godot编辑器控制台也能按执行时机实时显示循环内的打印内容。

这个现象是Godot编辑器控制台的刷新机制导致的：
编辑器控制台是运行在主线程的UI组件，只有当主线程的事件循环拿到执行权时，才会渲染缓冲区里积攒的日志内容。同步while循环会持续占用主线程，循环执行期间UI刷新逻辑完全得不到调度，日志就会一直存在缓冲区里，直到循环结束主线程空闲才一次性渲染出来。
触发断点时调试器会暂停主线程逻辑、强制刷新UI状态，所以能看到实时输出；操作系统终端独立于Godot主线程，采用行缓冲策略，遇到换行就会立刻输出内容，所以不会有这个问题。

可以根据自己的需求选择任意一种方案：

• 强制刷新标准输出缓冲区
  每次print调用后追加一行OS.flush_stdout()，这个API会强制把当前输出缓冲区的内容推送到所有绑定的输出端，大部分Godot版本下可以直接让编辑器控制台拿到实时日志，不需要改动原有循环的执行时序：

  print("Generation at ", round(tunnels_carved / num_tunnels * 100), "%")
  OS.flush_stdout()
  

• 每轮循环让出一帧主线程调度权
  如果不要求生成逻辑在单帧内跑完，可以在循环末尾加await get_tree().process_frame，让主线程每轮循环都有时间处理UI刷新、日志渲染。注意加了这行后所在方法会变成异步协程，调用方如果依赖生成完成的时序，要配合await或者信号使用：

  while tunnels_carved < num_tunnels:
      # 原有生成逻辑
      tunnels_carved += 1
      print("Generation at ", round(tunnels_carved / num_tunnels * 100), "%")
      OS.flush_stdout()
      await get_tree().process_frame()
  

• 将耗时生成逻辑移到子线程执行
  子线程执行不会阻塞主线程的事件循环，里面的print内容会被编辑器控制台实时捕获。注意Godot不允许子线程直接操作节点、修改TileMap数据，可以在子线程里生成完所有隧道的坐标数据，再通过信号或者call_deferred切回主线程完成TileMap的绘制，这种方案还能避免长时间循环导致编辑器/游戏界面卡死。

内容的提问来源于stack exchange，提问作者NewBoard