setWindowOpacity()使整个窗口及子控件统一透明，适合淡入动画而非自定义皮肤；真透明需同时设置Qt::FramelessWindowHint和WA_TranslucentBackground，并手动实现拖拽缩放，注意跨平台差异与DPI适配。
setWindowOpacity() 会让整个窗口和所有子控件一起变透明
这是最直观的透明设置方式，但也是最容易误用的。调用 setWindowOpacity(0.7) 后，按钮、文字、输入框全都会跟着变淡，不是“背景透明、内容清晰”，而是“整块玻璃罩子”。它适合做淡入动画或临时遮罩，不适合自定义皮肤窗口。
真正实现“背景透明 + 控件不透明”要配对使用两个属性
关键不在透明度数值，而在窗口的绘制通道是否打开。必须同时满足：
-
setWindowFlags(windowFlags() | Qt::FramelessWindowHint)—— 先去掉系统边框，否则透明背景会被边框挡住 -
setAttribute(Qt::WA_TranslucentBackground, true)—— 打开 alpha 通道支持，让 QPainter 或样式表里的透明色能真正生效
缺一不可。只设 WA_TranslucentBackground 而没去边框，Windows 上可能直接黑屏；只去边框不设透明属性，窗口背景仍是默认灰或白，border-radius 也压根不会圆角。
无边框后窗口无法拖动/缩放，得自己补事件逻辑
去掉边框不是终点，而是起点。此时 mousePressEvent、mouseMoveEvent、mouseReleaseEvent 全都失效，窗口钉死在原地。常见做法是：
- 在标题栏区域（比如一个
QLabel）重写这三个事件，记录鼠标按下位置和窗口原始坐标 - 移动时用
move(event->globalPosition().toPoint() - m_dragPos)计算新位置 - 右下角区域监听鼠标进入+拖拽，手动调用
resize()并限制最小尺寸
注意：如果后续还要加阴影，QGraphicsDropShadowEffect 会把窗口内容往外扩，但无边框窗口本身没有边距，阴影容易被裁掉——得给主布局加 setContentsMargins() 预留空间。
跨平台渲染差异必须提前验证
同一段代码在 Windows/macOS/Linux 上表现可能完全不同：
- Windows 需 DWM 开启才支持
WA_TranslucentBackground，Win7 默认关，Win10/11 一般开；关闭时窗口变黑或纯白 - macOS 对透明和圆角支持最好，但
QPainter自绘圆角需配合setMask()才彻底裁切，否则仍见直角 - Linux X11 下依赖合成管理器（如 Mutter、KWin），Wayland 原生支持但部分 Qt 版本驱动不稳，实测 Qt6.5+ 较可靠
最易被忽略的是 DPI 缩放：高分屏下 QPainter 绘制的阴影偏移量、圆角半径若没乘 devicePixelRatioF()，在 200% 缩放屏幕上会看起来模糊或错位。
