Linux 终端动态进度条实现涉及回车换行控制、行缓冲机制及 ANSI 颜色码应用。文章解析了 \r 与 \n 的区别，演示了如何通过 fflush 强制刷新缓冲区，并提供了基础版与彩色增强版的 C 语言代码实现。包含 Makefile 构建流程及主函数测试逻辑，适用于下载、编译等场景的交互优化。
在 Linux 开发中，进度条是最基础也最实用的系统程序之一。无论是文件下载、编译构建还是数据处理，一个直观的动态进度条能极大提升用户体验。但看似简单的进度条，背后藏着行缓冲区、回车换行区别、字符刷新等关键知识点。本文从基础概念入手，先拆解进度条的实现逻辑，再逐步实现'固定速度'和'自适应进度'两个版本，最后优化细节让进度条更流畅美观。
在动手写代码前，必须先理清 3 个关键概念，否则容易出现'进度条不刷新''换行错乱'等问题。
\n）：光标移动到下一行的行首，但不会回到当前行开头；我们日常使用它的时候其实是回车 + 换行的作用 (=/r/n)。\r）：光标回到当前行的行首，但不会移动到下一行。\r 让光标回到行首，再重新打印新的进度信息。C 语言的 printf 函数默认是'行缓冲'—只有遇到 \n、缓冲区满或手动刷新（fflush(stdout)）时，才会把缓冲区的内容输出到终端。
错误示例：
#include <stdio.h>
int main() {
printf("hello Lotso!");
sleep(3);
return 0;
}
printf 而不加 \n 或 fflush，内容会一直存在缓冲区，终端看不到任何输出，这就是很多人写进度条'没反应'的原因。注意：虽然没显示出来，但是我们的 C 语言默认是顺序结构的，一定是先执行 printf 再执行 sleep 的。
示例修正：
#include <stdio.h>
int main() {
printf("hello bite!");
fflush(stdout);
sleep(3);
return 0;
}
练手倒计时小程序：
#include <stdio.h>
#include <unistd.h>
int main() {
int cnt = 10;
for (; cnt >= 0; cnt--) {
printf("倒计时：% -2d\r", cnt); // 注意格式控制
fflush(stdout);
sleep(1);
}
printf("\n");
return 0;
}
一个完整的动态进度条通常包含 3 部分：
= 等字符填充，直观显示完成比例；|/-\ 循环切换，提示程序正在运行。基于基础框架，我们会慢慢优化实现出'彩色区分 + 速度显示 + 多场景适配'的进度条，核心分为头文件、实现文件、主函数三部分。
这个版本的其他文件我就不写了，就展示一个 process.c：
#include "process.h"
#include <string.h>
#include <unistd.h>
#define NUM 101
#define STYLE '=' // version1
void process_v1() {
char buffer[NUM];
memset(buffer, '\0', sizeof(buffer));
const char* lable = "|/-\\";
int len = strlen(lable);
int cnt = 0;
while (cnt <= 100) {
printf("[%-100s][%d%%][%c]\r", buffer, cnt, lable[cnt % len]);
fflush(stdout);
buffer[cnt] = STYLE;
cnt++;
usleep(50000);
}
printf("\n");
}
为了方便编译和清理，编写 Makefile 实现自动化构建，只需一条命令即可生成可执行文件：
Bin=process_bar
Cc=gcc
Src=$(wildcard *.c)
Obj=$(Src:.c=.o)
$(Bin):$(Obj)
@echo "$^ link to $@"
@$(Cc)-o$@ $^
%.o:%.c
@echo "compiling $< to $@"
@$(Cc)-c $<
.PHONY:clean
clean:
@echo "File cleanup complete"
@rm -f $(Obj) $(Bin)
.PHONY:debug
debug:
@echo "Bin: $(Bin)"
@echo "Cc: $(Cc)"
@echo "Src: $(Src)"
@echo "Obj: $(Obj)"
定义进度条回调函数类型和核心接口，方便后续扩展和复用：
#pragma once
#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>
// 定义进度条回调函数类型：适配不同场景的进度刷新逻辑
typedef void (*flush_t)(double total, double current, double speed, const char* userinfo);
// 彩色动态进度条核心接口
// total：总进度（如文件总大小）
// current：当前进度（如已下载大小）
// speed：当前速度（如 MB/s）
// userinfo：附加信息（如单位）
void Process_version(double total, double current, double speed, const char* userinfo);
集成颜色控制、进度计算、动态刷新，是进度条的核心：
#include "process.h"
#include <string.h>
// 进度条配置参数
#define SIZE 103 // 进度条缓冲区大小（适配 100%+ 额外字符）
#define LABEL '=' // 进度填充字符
// ANSI 颜色码定义
#define COLOR_GREEN "\033[32m"
#define COLOR_GRAY "\033[90m"
#define COLOR_CYAN "\033[36m"
#define COLOR_RESET "\033[0m"
#define COLOR_RED "\033[31m"
#define COLOR_YELLOW "\033[33m"
#define COLOR_BLUE "\033[34m"
#define COLOR_MAGENTA "\033[35m"
#define COLOR_WHITE "\033[97m"
#define COLOR_BLACK "\033[30m"
// 彩色动态进度条实现
void Process_version(double total, double current, double speed, const char* userinfo) {
// 边界处理：当前进度超过总进度时直接返回
if (current > total) {
return;
}
// 动态光标：循环切换，提示程序运行中
static const char* lable = "|/-\\";
static int index = 0; // 静态变量，记录光标位置，避免每次重置
int size = strlen(lable);
// 1. 计算比率
double rate = current * 100.0 / total;
char out_bar[SIZE];
memset(out_bar, '\0', sizeof(out_bar));
// 2. 填充进度字符
int i = 0;
for (; i < (int)rate; i++) {
out_bar[i] = LABEL;
}
// 3. 彩色打印进度条（分颜色区分不同部分，视觉更清晰）
printf(COLOR_RED "[%-100s]", out_bar); // 进度主体（红色）
printf(COLOR_BLUE "[%5.1lf%%]", rate); // 百分比（蓝色）
printf(COLOR_CYAN "[%c]", lable[index]); // 动态光标（青色）
printf(COLOR_YELLOW "| %.1lf/%.1lf,speed: %.1lf%s\r", current, total, speed, userinfo); // 附加信息（黄色）
printf(COLOR_RESET); // 重置颜色，避免污染后续输出
// 手动刷新缓冲区，确保内容实时显示
fflush(stdout);
// 更新光标索引（循环切换）
index++;
index %= size;
// 4. 进度条完成，换行
if (current >= total) {
printf("\r\n");
}
}
模拟多场景下载任务，测试进度条的适配性和稳定性：
#include "process.h"
#include <unistd.h>
#include <stdlib.h>
#include <time.h>
// 全局配置（可根据实际场景修改）
double gtotal = 1024.0; // 默认总进度（如 1024MB）
double gspeed = 1.0; // 默认速度
// 模拟下载任务：调用进度条回调函数刷新进度
void Download(double total, flush_t cb) {
double current = 0.0; // 模拟不同网络速度（模拟实际场景中速度波动）
double level[] = {0.01, 0.05, 10.0, 20.0, 24.0, 38.0, 50.0, 68.9};
int num = sizeof(level) / sizeof(level[0]);
while (1) {
// 模拟下载耗时（1 秒刷新一次）
usleep(1000000);
// 随机选择当前速度（模拟网络波动）
double speed = level[rand() % num];
current += speed;
// 边界处理：进度达到 100% 时终止
if (current >= total) {
current = total; // 确保进度不超过 100%
cb(total, current, speed, "MB/s");
break;
} else {
// 刷新进度条
cb(total, current, speed, "MB/s");
}
}
}
int main() {
// 初始化随机数种子，模拟速度波动
srand(time(NULL));
// 测试 4 个不同大小的下载任务，验证进度条适配性
printf("download: \n");
Download(gtotal, Process_version);
printf("download: \n");
Download(102.0, Process_version);
printf("download: \n");
Download(110.9, Process_version);
printf("download: \n");
Download(900.0, Process_version);
return 0;
}
实际操作过程：
[user@VM-4-4-centos lesson12--Progress]$ ll
total 16
-rw-rw-r-- 1 user user 1620 Nov 28 10:27 main.c
-rw-rw-r-- 1 user user 344 Nov 28 08:55 Makefile
-rw-rw-r-- 1 user user 3078 Nov 28 10:22 process.c
-rw-rw-r-- 1 user user 533 Nov 28 10:22 process.h
[user@VM-4-4-centos lesson12--Progress]$ make
compiling main.c to main.o
compiling process.c to process.o
main.o process.o link to process_bar
[user@VM-4-4-centos lesson12--Progress]$ ./process_bar
download: [====================================================================================================][100.0%][|]|1024.0/1024.0,speed: 24.0MB/s
download: [====================================================================================================][100.0%][\]|102.0/102.0,speed: 50.0MB/s
download: [====================================================================================================][100.0%][-]|110.9/110.9,speed: 68.9MB/s
download: [====================================================================================================][100.0%][/]|900.0/900.0,speed: 24.0MB/s
[user@VM-4-4-centos lesson12--Progress]$ make clean
File cleanup complete
执行 ./process_bar 后，终端会输出 4 个下载任务的进度条，每个部分颜色区分清晰：
= 填充部分）；|/-\ 循环切换）；进度完成后自动换行，后续任务不重叠，整体流畅无错乱。
注意：其中动态光标只与调用的这个函数有关，不管进度条动不动，他都是得转动的。还有就是大家如果想再优化一下的话可以试着把 = 替换成色块这样会更加清晰，其它的优化大家也可以自己想想尝试一下。
一个高质量的进度条，不仅是功能的补充，更是用户体验的提升。本文从基础原理到实战开发，再到优化扩展，带你吃透 Linux 终端进度条的核心逻辑，实现的彩色动态进度条可直接复用在下载、编译、数据处理等场景。掌握行缓冲区、回车换行、ANSI 颜色码等知识点后，你还可以举一反三，开发出更多终端交互工具（如倒计时、进度百分比动画）。Linux 终端开发的魅力就在于此——看似简单的功能，背后藏着扎实的底层逻辑，吃透这些细节，才能写出更稳定、更优雅的代码。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online