PHP CLI中用echo覆盖同一行显示进度需用\r回车符重置光标，配合ob_implicit_flush(true)、flush()和ob_flush()强制实时输出，结合str_pad()和sprintf()控制进度条格式，注意ANSI颜色兼容性及性能优化。
PHP CLI 下用 echo 覆盖同一行显示进度
CLI 环境没有 DOM，不能靠 HTML + JS 更新元素，只能靠终端“光标回退”实现覆盖式刷新。核心是用 \r（回车符）把光标拉回行首，再输出新内容，视觉上就是同一行在动。
常见错误是只用 \n 换行，结果刷出几百行，根本不是进度条；或者忘了 flush() 和 ob_flush()，PHP 缓存了输出，卡到最后才蹦出来。
- 必须在每次输出后调用
echo "\r" . $text，而不是"\n" - 必须关闭输出缓冲：
ob_end_flush()或全程禁用：ob_implicit_flush(true) - 要强制刷新：顺序执行
echo→flush()→ob_flush() - Windows CMD 对
\r支持稳定，Linux/macOS 终端也完全没问题
str_pad() 和 sprintf() 控制进度条宽度与对齐
纯文字进度条（比如 [=====> ] 50%）需要固定总长、动态填充、百分比对齐。硬拼字符串容易错位，尤其中文或不同字体下空格宽度不一。
推荐用 str_pad() 做右侧补空格保证总宽，用 sprintf() 格式化数字和符号，避免手动数空格。
立即学习“PHP免费学习笔记（深入）”；
- 设总长 50 字符：
$barLength = 50，已加载部分用str_repeat("=", $done) - 用
str_pad($leftPart, $barLength, " ", STR_PAD_RIGHT)补齐，防终端截断 - 百分比统一用
sprintf("%3d%%", $percent)，确保占 4 字符（如100%），对齐不跳 - 别用全角空格或中文字符做填充，终端渲染不可控
循环中 sleep() 时间太短导致 CPU 占用高
模拟进度时常用 for ($i = 0; $i ，但 PHP 的 <code>sleep() 最小单位是秒，0.1 会被截断为 0，实际不休眠，循环飞转，CPU 直奔 100%。
正确做法是用 usleep(100000)（10 万微秒 = 0.1 秒），或更稳妥地用 time_nanosleep(0, 100000000)（纳秒级）。
-
sleep(0.1)等价于sleep(0)，无效 -
usleep()参数是整数微秒，100000是安全下限，再小可能被系统忽略 - 如果进度依赖真实耗时（比如文件读取），就别硬 sleep，改用每次处理完立刻更新显示
- 注意 CLI 脚本超时：
set_time_limit(0)防止被中断
ANSI 转义序列让进度条带颜色但别滥用
加个绿色 [==> 或红色 [xx] 很直观，用 ANSI 颜色码就行，比如 \033[32m（绿）、\033[0m（重置）。但不是所有环境都支持——Windows 旧版 CMD 默认关掉 ANSI，会直接打印乱码字符。
判断是否启用颜色：用 function_exists('posix_isatty') && posix_isatty(STDOUT)，或者简单点，加个开关参数控制。
- 颜色码必须成对出现：
\033[32m...内容...\033[0m，漏掉重置会导致后续所有输出变色 - Windows 10+ 默认开启 ANSI，但老服务器或 Docker 容器里可能没开，别默认依赖
- 别用背景色（如
\033[41m），某些终端反色显示反而看不清 - 如果只是调试用，颜色可选；上线脚本建议默认无色，加参数
--color再启用
真正难的不是画出那根横条，而是让每次 echo 都及时出现在屏幕上，且不被缓冲吞掉、不被终端截断、不因 sleep 失效拖垮机器——这些细节都在底层 IO 和系统调用里，一碰就露馅。
