BaseConsole::progress()需在循环中每次传入当前数和总数，并立即调用BaseConsole::output()刷新；须校验总数>0、避免非TTY环境、禁用冲突组件、Windows下优先用终端替代方案、降低高频刷新、分段标注多阶段任务。
yiihelpersBaseConsole::progress() 怎么用才不卡住
进度条在 Console 命令里不是“调用就动”，BaseConsole::progress() 默认依赖 stdout 缓冲行为，不手动刷新就卡在 0% 或只显示最后一帧。
- 必须在循环中每步都调用
BaseConsole::progress()，且传入当前完成数和总数（不能只传百分比） - 调用后立刻执行
BaseConsole::output()强制刷屏，否则终端看不到更新 - 避免在非 TTY 环境（比如重定向到文件、CI 日志流）里启用进度条，会输出乱码或报错
PHP Warning: fwrite(): failed to write X bytes - 总数为 0 或负数时会除零，需提前校验：
if ($total
for ($i = 0; $i <h3>为什么 runAction() 里调用进度条没反应</h3><p>Yii2 Console 命令的 <code>runAction()</code> 是异步调度入口，但 <code>BaseConsole::progress()</code> 不感知 Action 生命周期，它只管写 stdout。问题常出在输出被 Yii 的日志/缓冲机制截断。</p>
- 确保命令类继承
yiiconsoleController，而不是普通Controller - 禁用日志自动 flush：在命令开头加
Yii::getLogger()->flushInterval = 0; - 不要在
beforeAction()或afterAction()中调用进度条——它们不在主执行流里，stdout 可能已关闭 - 如果用了
yiiconsolewidgetsProgressBar（第三方），它和BaseConsole::progress()冲突，选一个用到底
Windows 下进度条闪烁或错位
Windows CMD 和 PowerShell 对 ANSI 转义序列支持不稳定，BaseConsole::progress() 底层用
回车覆盖，但在某些终端会残留旧字符。
- 优先用 Windows Terminal 或 Git Bash 运行，CMD 默认禁用
- 临时方案：每次更新前先输出足够空格清掉上一行，再回车重写：
echo str_repeat(' ', 80) . " "; - 检查
BaseConsole::$isAnsiSupported是否为false，是则降级为纯文本百分比（如[====> ] 40%） - 别依赖
BaseConsole::ansiFormat()给进度条加色——Windows 原生命令行默认不解析 ANSI 颜色
大文件处理时进度条变慢甚至阻塞
进度条本身不耗资源，但高频调用 BaseConsole::progress() + output() 在 IO 密集场景下会放大系统调用开销，尤其配合 fopen() 读大文件时明显拖慢。
- 降低刷新频率：每 1% 更新一次太密，改为每 5% 或固定步长（如每 10MB）更新：
if ($i % $step === 0) { BaseConsole::progress(...); BaseConsole::output(); } - 避免在
fgets()每行后都刷进度——改用ftell()+fstat()计算偏移百分比 - 如果用
yiihelpersFileHelper::copyDirectory()类批量操作，进度条要套在外层循环，别嵌进递归内部 - 注意
BaseConsole::output()底层是fwrite(STDOUT, ...)，频繁小写入比单次大写入慢数倍
真正麻烦的是混合了数据库查询和文件 IO 的任务——进度条数值难对齐，这时候别硬凑统一百分比，分段标清楚更靠谱，比如 “[DB] 1200/1200 → [FILE] 3/15”。
