C语言实现类wget动态进度条：回车符\r与fflush原理

不晚

发布时间：2026-10-14 | 5人浏览过

原创

在命令行工具开发中，模拟 wget 或 curl 等工具的实时下载进度条能显著提升用户体验。其核心原理并非复杂的图形库调用，而是利用终端控制序列中的回车符（\r）进行原地覆盖，并结合 fflush 确保数据实时可见。

运行结果

执行代码后，终端将显示一条不断增长的进度条，百分比数字随之更新，直到达到100%后换行结束。效果类似于：progress:[############################################]100%

准备条件

要实现此效果，需引入以下头文件并理解关键函数：

<stdio.h>：用于 printf 输出和 fflush 刷新。
<stdlib.h>：用于 malloc 内存分配。
<unistd.h>：用于 usleep 控制刷新速度。

操作步骤

第1步：初始化进度条缓冲数组

目的：创建一个足够长的字符数组，填充为标记符号（如 '#），以便后续直接截取子串作为进度条主体。

操作：

定义进度条总长度 len（例如 60）。
使用 malloc 分配 len + 1 个字节的内存，以容纳结尾的 '\0'。
遍历数组，将所有元素赋值为 '#'。

第2步：编写动态打印循环

目的：通过改变打印指针位置和追加百分号，模拟进度增加的过程。

操作：

设置循环次数，从 0 到 len - 1。
在每次迭代中，使用 printf 输出字符串格式："progress:[%s]%d%%\r"。
关键点：%s 对应的参数应为 bar + len - i。随着 i 增加，指针向后移动，输出的 '#' 数量逐渐增多。
末尾添加 \r（回车符）。它的作用是将光标移至当前行首，而不是换行，从而允许下一次打印覆盖上一次的内容。

第3步：强制刷新输出缓冲区

目的：解决终端或 stdout 的默认行缓冲问题，确保 printf 内容立即显示。

操作：

在 printf 之后立即调用 fflush(stdout)。若省略此步，由于缓冲区未满且无换行符，屏幕可能长时间保持空白或一次性刷新。

第4步：控制刷新频率

目的：让肉眼能观察到进度条的流动效果，而非瞬间完成。

操作：

使用 usleep(100000) 暂停约 0.1 秒。数值越大，进度条走得越慢。

完整代码示例

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

// 类似wget的进度条的实现，实际就是转移符\r的使用
int main(int argc, char *argv[])
{
    unsigned len = 60;
    // 分配内存，+1 为了存储字符串结束符 '\0'
    char *bar = (char *)malloc(sizeof(char) * (len + 1));
    if (!bar) {
        perror("malloc failed");
        return 1;
    }

    // 初始化填满 '#' 的字符串
    for (int i = 0; i < len + 1; ++i)
    {
        bar[i] = '#';
    }

    // 动态更新进度条
    for (int i = 0; i < len; ++i)
    {
        // \r 回到行首，[%s] 是变化的进度部分，%d%% 是变化的百分比
        printf("progress:[%s]%d%%\r", bar + len - i, i + 1);
        
        fflush(stdout); // 必须刷新缓冲区，否则不会即时输出
        
        usleep(100000); // 休眠 0.1 秒，可根据需要调整
        // sleep(1);   // 若要更慢，可使用 sleep()
    }
    
    // 最后输出一个换行符，避免下次输入在同一行
    printf("\n");
    
    free(bar); // 释放内存
    return 0;
}