Go实现文件进度条需先用os.Stat获取总大小，再通过自定义io.Reader或bufio.Scanner实时累加已读字节数或行数，配合原子操作、节流刷新及TTY兼容处理确保进度准确一致。
用 os.Stat 获取文件总大小再配合 io.Reader 实时读取字节数
进度展示的前提是知道“总共要读多少”和“当前读了多少”。Golang 没有内置的带进度回调的文件读取函数，必须自己组合。直接用 os.Stat 拿到文件 Size() 是最稳妥的起点——注意别用 os.Open 后调 Seek(0, io.SeekEnd)，某些只读文件系统或管道会失败。
实际读取时，推荐用 bufio.NewReader 包一层，再通过 Read 或 ReadBytes 循环读，每次读完就累加已读字节数。不要用 io.Copy，它不暴露中间进度。
-
os.Stat返回的Size()是准确的，但对符号链接需先os.Stat（不是os.Lstat）确保拿到目标文件大小 - 如果文件可能被并发修改（如日志轮转），
Size()和实际读取长度可能不一致，此时进度条只能作为估算参考，建议加日志警告 - 避免在循环里反复调
fmt.Printf刷新进度——高频输出会拖慢整体速度，用time.AfterFunc或简单计数限频（比如每 1% 更新一次）更合理
用 sync.AtomicInt64 安全更新已读字节数（尤其多 goroutine 解析时）
如果解析逻辑本身开了多个 goroutine 并行处理数据块（比如按行切分后分发），各 goroutine 都要上报自己的读取量，就必须用原子操作。直接用普通 int64 变量 + mutex 也行，但 sync.AtomicInt64 更轻量、无锁，且 Go 1.19+ 原生支持。
关键点：原子变量只管“已读字节数”的累加，**不要**用它存“当前百分比”——百分比是派生值，应在展示线程里按需计算（避免重复除法、浮点误差累积）。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 初始化用
var readBytes sync.AtomicInt64，每次读完一批数据调readBytes.Add(int64(n)) - 主进度刷新 goroutine 里用
readBytes.Load()读当前值，再除以总大小算百分比 - 若解析过程涉及解压缩（如
gzip.Reader），readBytes应该累加的是原始压缩文件的字节数，不是解压后内容长度——否则进度会“跳变”甚至超 100%
处理 CSV/JSONL 等结构化文件时，进度单位用“行数”比“字节数”更符合用户直觉
用户关心的是“导入了多少条记录”，不是“读了多少 KB”。所以当文件格式明确（如每行一条 JSON、CSV 行有明确换行符），优先按行计数。但要注意：行边界识别必须和实际解析逻辑一致，否则会出现“显示读了 1000 行，实际只成功解析 950 行”的错位。
典型做法是用 bufio.Scanner 逐行扫描，每次 Scan() 成功就递增行计数器。注意 Scanner 默认 64KB 缓冲区，遇到超长行会失败，可提前用 scanner.Buffer(make([]byte, 1024*1024), 1024*1024) 扩容。
- CSV 文件若含换行符（字段内回车），
bufio.Scanner会误切，此时必须用encoding/csv.Reader的Read()方法，并在每次成功Read()后计数 - JSONL（每行一个 JSON）可用
json.Decoder配合bufio.Scanner，但记得在scanner.Scan()后立即用decoder.Decode()，避免 scanner 覆盖缓冲区 - 行计数进度无法反映单行解析耗时差异（比如某一行含巨大嵌套 JSON），必要时可叠加字节进度作辅助参考
终端进度条刷新要兼容不同环境：TTY 检测 + 回车覆盖 + ANSI 清行
在终端打印进度条，核心是用 \r 回到行首覆盖重写，而不是不断换行。但前提是程序运行在真正 TTY 中——CI 环境、重定向到文件、IDE 控制台可能不支持，强行刷屏会污染日志。
用 isatty.IsTerminal(os.Stdout.Fd())（需引入 golang.org/x/sys/unix 或第三方 github.com/mattn/go-isatty）判断是否为交互终端。非终端环境改用简单日志输出（如每 10 秒打一行 “Processed X / Y records”）。
- ANSI 清行序列
\033[2K放在进度字符串前，能防止上一次内容残留（尤其进度缩短时） - 避免用
fmt.Print("\r...")，而用fmt.Fprintf(os.Stdout, "\033[2K\r%s", progressStr)，确保原子输出 - Windows CMD 对 ANSI 支持有限，Go 1.19+ 默认启用虚拟终端模式，但旧版需手动调
winio.EnableVirtualTerminalProcessing；更省事的做法是检测runtime.GOOS == "windows"后降级为纯文本刷新
