如何在命令行中输出进度条
内容提要
文章介绍了在命令行中输出动态进度条的方法，核心是使用回车符\r回到行首覆盖当前行，以及ANSI控制序列（如\033[3A）移动光标实现多行刷新。文中提供了PHP示例代码，展示单行和多行进度条的实现，并提及了相关TUI框架（如OpenTUI、Ratatui）和Symfony Console的简化方案。
延伸解读
核心原理：回车符与ANSI控制序列
文章指出，命令行输出默认是追加模式，要实现动态更新，关键在于使用回车符\r回到行首覆盖当前行，以及ANSI控制序列（如\033[3A）移动光标实现多行刷新。这些控制序列是终端交互的基础，理解它们有助于开发更复杂的命令行界面。
视觉假象与格式化细节
进度条的实现依赖于视觉假象：通过固定部分（如方括号和百分比符号）和变化部分（如#号数量）的组合，让用户感觉内容在动态更新。文章特别提醒，数字格式化（如%3d）很重要，否则在达到100%时会出现跳跃，影响美观。
多行刷新与实用框架
对于多行进度条，文章介绍了使用ANSI控制序列移动光标的方法，并提供了PHP示例。同时，文章列举了多种语言的TUI框架，如TypeScript的OpenTUI、Rust的Ratatui，以及PHP的Symfony Console，其中Symfony Console的section()方法可以简化多区域刷新，适合快速开发。
Q&A
如何在命令行中实现单行进度条？
使用回车符\r回到行首，然后重新输出整行内容覆盖旧内容。例如：printf("progress: [%-50s] %d%%\r", str_repeat('#', $i), $i * 2); 每次循环都从行首重绘。
命令行中\r和\n有什么区别？
\n是换行，将光标移到下一行；\r是回车，将光标移到当前行的行首，不换行。利用\r可以覆盖当前行内容。
如何用ANSI控制序列在命令行中移动光标到上一行？
使用ESC[<n>A，其中<n>是向上移动的行数。在PHP中可写作\033[3A表示向上移动三行。
如何实现多行进度条？
先输出多行内容，然后使用ANSI控制序列（如\033[3A）将光标移到第一行，再逐行覆盖输出。示例代码中通过printf("\033[%dA", $lineCount)移动光标，并用\r\033[2K清除行后重绘。
在PHP中如何清除当前整行？
使用ANSI控制序列\033[2K清除当前整行，通常与\r配合使用，先回到行首再清除。
有哪些命令行TUI框架可用于构建进度条？
常见的有：TypeScript的OpenTUI（OpenCode使用）、pi-tui（Pi使用）、Ink（React CLI）、cli-progress；Go的Bubble Tea；Rust的Ratatui；PHP的Symfony Console。
Symfony Console如何简化多行进度条更新？
使用ConsoleOutput的section()方法创建区域，然后调用overwrite()方法覆盖整个区域内容，无需手动处理光标移动。
