本文详解为何 PySide2 无法默认捕获 tqdm 输出（因其绕过 sys.stdout.write 直接操作终端控制序列），并提供两种可靠方案：修改 tqdm 配置使其兼容重定向流，或适配 jMetalPy 的 ProgressBarObserver 以显式触发标准输出。
本文详解为何 pyside2 无法默认捕获 tqdm 输出（因其绕过 `sys.stdout.write` 直接操作终端控制序列），并提供两种可靠方案：修改 tqdm 配置使其兼容重定向流，或适配 jmetalpy 的 `progressbarobserver` 以显式触发标准输出。
tqdm 默认行为是直接向 sys.stderr 写入带 ANSI 控制符（如回车 \r、清行 \x1b[K）的进度条，并使用 file=sys.stderr + flush=True 绕过常规 sys.stdout 重定向机制——这正是你的 EmittingStream 未能捕获 tqdm 文本的根本原因：它只监听 sys.stdout，而 tqdm 默认走 stderr，且其动态刷新逻辑依赖原始终端能力，在 GUI 文本框中无法渲染“覆盖式”进度条。
✅ 推荐方案一：强制 tqdm 使用可重定向的 stdout 并禁用控制符
在初始化 tqdm 时显式指定 file=sys.stdout、dynamic_ncols=False、leave=False，并关闭所有 ANSI 转义（disable=False 仅用于调试，生产环境设为 True 以避免乱码）：
import sys
from tqdm import tqdm
# 确保 tqdm 输出到已重定向的 stdout
progress_bar = tqdm(
total=100,
file=sys.stdout, # 关键：强制走 stdout
ascii=True, # 避免 Unicode 控制符
dynamic_ncols=False, # 禁用动态列宽（GUI 无终端尺寸）
leave=False, # 完成后不保留最后一行（防重复）
disable=False # 设为 True 可完全禁用 tqdm（仅需日志）
)
⚠️ 注意：若 sys.stdout 已被 EmittingStream 替换，此配置即可让 tqdm 文本正常触发 textWritten.emit() 信号，进而追加到 QTextBrowser。
✅ 推荐方案二：改造 jMetalPy 的 ProgressBarObserver（如你所做，但更健壮）
你添加 print(..., file=sys.stdout) 是有效思路，但建议进一步优化：避免重复打印、兼容 tqdm 关闭逻辑，并统一输出格式：
class ProgressBarObserver(Observer):
def __init__(self, max: int) -> None:
self.progress_bar = None
self.progress = 0
self._max = max
def update(self, *args, **kwargs):
if not self.progress_bar:
# 强制 tqdm 使用重定向后的 stdout
self.progress_bar = tqdm(
total=self._max,
file=sys.stdout,
ascii=True,
dynamic_ncols=False,
leave=False,
disable=False
)
evaluations = kwargs.get('EVALUATIONS', 0)
delta = evaluations - self.progress
if delta > 0:
self.progress_bar.update(delta)
self.progress = evaluations
# 同步输出纯文本日志（GUI 友好）
print(f"[Progress] Evaluations: {evaluations}/{self._max}", flush=True)
if self.progress >= self._max and self.progress_bar:
self.progress_bar.close()
print("[Done] Optimization completed.", flush=True)
? 关键注意事项：
- 始终调用 flush=True（或确保 EmittingStream.flush() 被正确调用），防止缓冲导致延迟；
- QTextBrowser.append() 是线程不安全的，若 update() 在非主线程调用（如算法后台线程），需通过 QMetaObject.invokeMethod 或信号槽跨线程安全更新；
- 若仍见红色文字，检查是否 sys.stderr 也被重定向——可将 EmittingStream 同时赋给 sys.stderr，或在 observer 中统一使用 print(..., file=sys.stdout)；
- 对于最终用户，建议 disable=True（静默模式）+ 自定义文本日志，体验更稳定。
总结：tqdm 与 GUI 的本质矛盾在于“终端交互式渲染”与“静态文本流”的范式差异。放弃模拟动态进度条，转而提供清晰、时序准确的文本进度日志，反而是 PySide2 应用中最可靠、最易维护的实践。
