必须开启qpainter::antialiasing才能实现曲线抗锯齿，仅用qpainterpath或drawpolyline无效；推荐整数笔宽、优先使用qpainterpath构造贝塞尔曲线，并注意qwidget与qopenglwidget后端差异及缩放影响。
QPainter::setRenderHint() 必须开启 Antialiasing
不加这句，所有曲线都是锯齿状的，哪怕用了 QPainterPath 或 drawPolyline。Qt 默认关闭抗锯齿，因为涉及光栅化性能开销，不是“画出来就自动平滑”。
实操建议：
- 在调用绘图函数前立即设置：
painter.setRenderHint(QPainter::Antialiasing, true) - 如果同时需要文字平滑，加上
QPainter::TextAntialiasing；但注意：某些嵌入式平台或旧显卡驱动下，TextAntialiasing可能被静默忽略 - 避免在循环里反复开关该 flag——它会触发渲染状态重置，影响性能
- 仅对矢量路径（如
QPainterPath、drawEllipse）生效；对位图（drawPixmap）无效
用 QPainterPath 比 drawPolyline() 更可靠
drawPolyline 对折线段抗锯齿效果弱，尤其在斜率突变处仍可见阶梯；而 QPainterPath 把整条曲线当一个拓扑对象处理，光栅化时能统一做边缘采样。
实操建议：
- 构造贝塞尔曲线优先用
QPainterPath::cubicTo或quadTo，别手动拆成大量短直线段 - 若数据源是离散点列，先用样条插值生成控制点，再转为
QPainterPath，而不是直接drawPolyline(points) - 路径添加完后，用
painter.drawPath(path)，不是painter.drawPolyline(path.toFillPolygon())—— 后者会破坏抗锯齿质量
笔宽（pen width）小于 1.0 会导致抗锯齿失效
当 QPen 的宽度设为 0（Qt 中表示“1 像素物理宽度”）或 0.5 等小数时，部分 Qt 版本（尤其是 Qt 5.12 以前）在启用 Antialiasing 后反而出现虚边、断线或颜色发灰。
实操建议：
- 固定使用整数笔宽：
QPen(Qt::black, 1)或QPen(Qt::black, 2) - 真需要细线时，改用
QPen(Qt::black, 1, Qt::SolidLine, Qt::RoundCap, Qt::RoundJoin)，确保端点和连接处也参与抗锯齿计算 - 避免
setCosmetic(true)和小数 width 同时使用——cosmetic 笔在高 DPI 下行为不稳定
QWidget vs QOpenGLWidget 渲染后端差异
在 QWidget 上启用了 Antialiasing，曲线看起来平滑；但换到 QOpenGLWidget 子类中重写 paintGL()，可能完全没效果——因为 OpenGL 渲染路径绕过了 QPainter 的抗锯齿逻辑。
实操建议：
- 确认当前 widget 类型：如果是
QOpenGLWidget，不要依赖QPainter::Antialiasing，改用 OpenGL 原生 MSAA 或 FXAA 后处理 - 若必须用 QPainter，在
QOpenGLWidget中调用beginNativePainting()/endNativePainting()切回光栅管线，但性能下降明显 - Qt 6 中
QPainter在 OpenGL 后端已大幅改进，但QPainterPath的曲线细分策略仍与软件渲染不同，实测建议始终在目标平台上验证
真正容易被忽略的是：抗锯齿不是“打开就完事”，它依赖路径构造方式、笔属性、设备像素比（devicePixelRatio()）、甚至窗口是否被缩放。同一段代码，在 100% 缩放的 4K 屏和 150% 缩放的笔记本上，锯齿表现可能完全不同。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
