libzip解压进度需通过预扫描累加所有文件st.size得总字节数，再在zip_fread()循环中累加实际读取量计算百分比；GUI中用原子变量+低频轮询更新，命令行优先用ANSI或平台适配清行回车，避免依赖\r覆盖。
用 libzip 解压时如何获取当前解压进度
直接靠 libzip 自带 API 无法拿到精确百分比——它不暴露已写入字节数或当前文件偏移。但你可以通过「解压前遍历所有文件并累加 zip_stat_t.size」得到总待解压字节数，再在每次调用 zip_fread() 后累加实际读取量，从而推算进度。
关键点：必须用 zip_stat_index() 或 zip_stat() 预扫描全部条目，不能只靠 zip_get_num_entries() 数文件个数——单个大文件就可能占 90% 体积。
- 先调用
zip_stat_init(&st)初始化结构体 - 循环
i从0到zip_get_num_entries(za, 0) - 1，用zip_stat_index(za, i, 0, &st)获取每个文件的st.size - 注意：如果 zip 包含目录或符号链接，
st.size为0，跳过即可，避免除零或进度异常
解压循环中怎么安全更新进度而不卡 UI
在命令行工具里，频繁刷新终端（比如每毫秒）反而拖慢解压；在 GUI 程序里，直接从解压线程发信号更新进度条又容易引发竞态。最稳的方式是「解压逻辑不主动刷新，由外部定时轮询」。
具体做法：把当前已处理字节数声明为原子变量 std::atomic<uint64_t> bytes_done{0}</uint64_t>，解压主循环里每次成功 zip_fread() 一段数据后，执行 bytes_done.fetch_add(n, std::memory_order_relaxed)；另起一个低频轮询线程（如每 200ms 检查一次），计算 (bytes_done.load() * 100) / total_bytes 并触发界面更新。
立即学习“C++免费学习笔记（深入）”；
- 别用
std::cout << "\r"实现覆盖刷新——Windows 控制台对\r支持不稳定，容易换行错乱 - 若用 ncurses 或更现代的终端库（如
cpp-terminal），优先调用其原生进度组件，而非手绘字符 - 注意
total_bytes是预扫描得出的压缩包内所有文件原始大小之和，不是 zip 文件自身大小
为什么 unzip 命令行工具的进度条不准
系统自带 unzip 的 `-v` 或第三方封装（如 libarchive）通常只显示「已解压文件数 / 总文件数」，本质是计数器而非字节级进度。这是因为解压过程涉及解密、解压缩、CRC 校验、写磁盘等多个阶段，真正耗时环节未必和字节数线性相关——比如一个 1KB 的加密文件可能比 100MB 的明文文件更慢。
所以如果你看到某工具标称“50%”，实际可能是第 1 个大文件刚解完、后面 99 个小文件还没开始，也可能是前 99 个秒解完、最后一个卡在磁盘 IO。真实进度只能按输出字节估算，且前提是目标文件系统支持 O_DIRECT 或足够快的缓存写入。
-
libzip默认用普通fwrite()写文件，受 libc 缓存影响，bytes_done更新快于磁盘落盘，进度条会「冲 ahead」 - 若需强一致性进度（如备份场景），应在每次
fwrite()后调用fflush()和fsync()，但性能下降明显，慎用
跨平台终端进度条渲染要注意什么
Linux/macOS 终端普遍支持 ANSI 转义序列（如 \033[2K\033[1G 清行回车），但 Windows 旧版 cmd 不识别，需要先调用 SetConsoleMode(GetStdHandle(STD_OUTPUT_HANDLE), ENABLE_VIRTUAL_TERMINAL_PROCESSING) 启用。
更稳妥的做法是检测环境：_WIN32 下优先尝试启用 VT，失败则退化为「当前文件名 + 已解字节数 / 总字节数」的静态文本行；其他平台直接用 ANSI。
- 别假设用户终端宽度——用
ioctl(TIOCGWINSZ)（Unix）或GetConsoleScreenBufferInfo()（Windows）获取列数，动态缩放进度条长度 - 进度值建议保留一位小数（如
62.3%），整数百分比在小文件解压时跳变太剧烈 - 完成时最后一行不要留空，用
\n换行确保光标位置可预测
真正难的不是算百分比，而是让「已解字节数」这个数字和用户感知的「快慢」尽量一致——解压速度受磁盘随机 IO、CPU 解压瓶颈、ZIP 中 Deflate 压缩率差异共同影响，同一包在不同机器上进度曲线可能完全不同。盯着数字不如关注最后那个 unzip done 输出是否准时出现。
