用\r覆盖输出是唯一可靠的基础方案：终端不支持编辑已输出文字，但支持\r将光标拉回行首再覆盖旧内容，这是所有进度条的底层逻辑，不依赖ANSI或第三方库，Windows PowerShell/WSL/macOS Terminal均原生支持。
用 \r 覆盖输出是唯一可靠的基础方案
终端不支持“编辑已输出文字”，但支持用 \r（回车符）把光标拉回行首，再用新内容覆盖旧内容。这是所有进度条的底层逻辑，不依赖 ANSI 转义、不依赖第三方库、Windows PowerShell / WSL / macOS Terminal 全部原生支持。
常见错误现象：进度条逐行堆叠、百分比跳变、末尾残留旧字符、光标卡在中间影响后续命令。
- 必须用
fmt.Print或fmt.Printf，禁用fmt.Println（它自动加\n） - 每次刷新前先输出
\r，再输出完整字符串（含空格填充），防止上一行更长时残留文字 - 任务结束时补一个
\n，否则下一条日志会粘在进度条末尾 - 某些 IDE 内置终端（如 VS Code 旧版集成终端）会禁用
\r刷新，务必在系统终端里验证
终端宽度变化或重定向时必须降级处理
用户缩放窗口、执行 ./cmd > log.txt、CI 环境中运行，都会让 \r 失效——这不是你代码写错了，而是终端状态不可控。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
golang.org/x/term检测是否为真实终端：term.IsTerminal(int(os.Stdout.Fd())) - 检查环境变量：
os.Getenv("CI") != ""或os.Getenv("TERM") == ""，满足任一条件就关闭进度条，只输出纯文本日志 - 获取宽度失败时（如管道重定向），fallback 到默认值（比如 60），不要 panic
- 动态宽度计算留足余量：
barWidth = max(20, width - 25)，25 是百分比、括号、空格等固定部分所需空间
并发任务中多个进度条不能直接共用 os.Stdout
多个 goroutine 同时调用 fmt.Print("\r...")，输出会交错撕裂：A 进度条刚写到一半，B 就把光标拉回去覆盖，结果出现 “[===23%] [==45%]” 这类乱码。
解决方案只有两个方向：
- 串行化输出：用 channel 或 mutex 控制写入顺序，但会拖慢整体响应，UI 显得卡顿
- 换成熟库：如
github.com/vbauerster/mpb/v8，它内部用单 goroutine 统一调度渲染，支持嵌套、速率估算、样式隔离，且无 CGO 依赖 - 别用
github.com/schollz/progressbar/v3的并发模式——它靠锁保护，但刷新节奏不同步，仍可能出现视觉错位
HTTP 下载场景必须绑定 io.TeeReader 才能实时更新
直接 io.Copy(dst, resp.Body) 是静默的，进度条收不到任何信号；而 resp.Header.Get("Content-Length") 又不一定存在（HEAD 被禁、分块传输、动态生成内容）。
安全做法：
- 优先尝试
http.Head获取Content-Length，若为空则 fallback 到无总长模式（只显示已读字节数，不显示百分比） - 初始化进度条后，用
reader := io.TeeReader(resp.Body, bar)包装原始 Body - 后续所有读取都走这个
reader，bar.Increment(n)会自动触发 - 别手动调
bar.SetCurrent()——TeeReader已经帮你做了，重复调反而导致数值错乱
终端宽度检测和并发调度是真正容易被忽略的复杂点。手撸 \r 很快能跑通单任务，但一旦进 CI、开多 goroutine、切小屏终端，问题就会集中爆发。不是代码写得不够“Go 风格”，而是终端本身就不稳定。
