QProgressBar正确使用需满足三点：范围必须设对（用setRange而非分开设min/max）、更新必须在主线程（子线程需信号槽通信）、不确定任务要设setRange(0, 0)启用循环动画；否则易卡顿、假死或显示错乱。
QProgressBar 用对了很简单，用错了会卡住、不刷新、显示错乱，甚至让整个 UI 假死。核心就三点：范围必须设对、更新必须在主线程、不确定任务要切到 setRange(0, 0) 模式。
setRange 和 setValue 必须配对使用
进度条不是“设个值就动”，它靠 value() 相对于 minimum() 和 maximum() 的比例算填充宽度。如果只调 setValue(50) 却没设范围，它默认用 0–99，结果你填 50 实际显示约 50.5%，看着就别扭。
- 明确任务总量时，用
setRange(0, total)，再按实际完成量调setValue(done) - 不要分开写
setMinimum()和setMaximum()—— 容易漏掉一个，直接用setRange()更安全 - 如果
setRange(0, 0)，进度条会变成循环动画（类似“正在加载…”），此时setValue()无效，别白费劲
跨线程更新 value 会崩溃或无响应
Qt 的 GUI 控件（包括 QProgressBar）只能由创建它的线程（通常是主线程）安全访问。你在子线程里直接调 progressBar->setValue(42)，程序大概率当场 crash，或者界面卡住不动。
- 正确做法是：子线程 emit 信号（如
progressChanged(int)），主线程的 slot 接收后调setValue() - 别用
QMetaObject::invokeMethod()强行跨线程调用 —— 容易出竞态，且 Qt6 已限制部分用法 - 如果只是模拟进度（比如定时器），那完全在主线程里做，不用跨线程
textVisible 和 format 容易被忽略的细节
默认文字居右、带百分号，但很多人想居中显示“75/100”或隐藏数字只留视觉条，结果发现 setTextVisible(false) 后整个条变窄、对齐错位。
-
setTextVisible(false)不影响进度条本体，但会让内部布局收缩，建议配合setAlignment(Qt::AlignCenter)使用 -
setFormat("%v/%m")显示 “23/100”，setFormat("剩余 %1s"_arg(100 - value))这种 lambda 格式在 Qt6.5+ 支持，旧版不认，得用槽函数手动更新 - 垂直进度条（
setOrientation(Qt::Vertical)）的文字默认在右侧，想居中得额外加setAlignment(Qt::AlignHCenter | Qt::AlignVCenter)
最常踩的坑是：把 setRange(0, 0) 当成“还没开始”，其实它是专用的不确定模式；还有人把耗时计算塞进 valueChanged 信号的 slot 里，导致 UI 线程阻塞。这些地方一卡，用户第一反应就是关掉程序。
