Windows需调用DwmExtendFrameIntoClientArea设负边距启用阴影；macOS须设置NSView的wantsLayer和shadow属性；Linux依赖WM或Wayland协议，无统一方案。
Windows上用DwmExtendFrameIntoClientArea实现阴影
Windows原生支持窗口阴影，但默认只对标准标题栏生效；自绘无边框窗口（WS_POPUP 或 WS_BORDER 关闭）必须手动启用。核心是调用 DwmExtendFrameIntoClientArea，传入负边距让系统在客户区外绘制阴影。
- 必须链接
dwmapi.lib，并在代码中#pragma comment(lib, "dwmapi.lib") - 调用前检查
DwmIsCompositionEnabled()，禁用Aero时函数无效且不报错 - 边距结构体
MARGINS设为{-1, -1, -1, -1}表示“全向扩展”，这是最简写法；设具体值（如{0, 0, 0, 1}）只向下扩展，阴影会不对称 - 仅对顶级窗口有效，子窗口调用无效；窗口需已创建（
HWND有效）且未被最小化
macOS上依赖NSView的wantsLayer和shadow属性
macOS没有等效的全局API，阴影必须由窗口内容视图（NSView）自身渲染。关键路径是：窗口 contentView → 启用 layer → 设置 shadow。
-
[view setWantsLayer:YES]必须在viewDidLoad或awakeFromNib中调用，延迟设置会导致阴影不生效 - 阴影对象通过
view.layer.shadow配置：shadowColor、shadowOffset、shadowRadius、shadowOpacity缺一不可 - 注意
shadowRadius单位是点（point），不是像素；高DPI屏下数值过大会模糊失真，建议 ≤8 - 若窗口使用
NSBorderlessWindowMask，需额外调用[window setOpaque:NO]和[window setBackgroundColor:[NSColor clearColor]]，否则阴影被背景遮盖
Linux上X11与Wayland的处理差异极大
Linux没有统一方案：X11靠窗口管理器（如KWin、Mutter）自动添加阴影，但要求窗口声明为“decorated”；Wayland则完全由客户端合成器控制，传统X11方法失效。
C++ Code Review Master
下载
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- X11下可尝试设置
_NET_WM_WINDOW_TYPE为_NET_WM_WINDOW_TYPE_NORMAL，并避免设置override-redirect；但效果取决于WM，无法保证 - Wayland下唯一可靠方式是使用
xdg-decoration协议请求服务器装饰（含阴影），或改用libdecor库封装逻辑 - 直接调用
XComposite或cairo自绘阴影极易出错：位置偏移、重绘撕裂、多屏缩放错乱，不推荐在应用层实现 - Qt、GTK等框架内部已适配，纯C++ + X11/wayland原生开发时，应优先委托给平台框架而非硬编码
跨平台封装时最容易忽略的三个细节
不同平台阴影触发时机、生效条件、视觉参数含义完全不同，强行抽象成一个接口极易出问题。
立即学习“C++免费学习笔记（深入）”；
- Windows的阴影在
SetWindowPos改变大小后可能消失，需重新调用DwmExtendFrameIntoClientArea；macOS则只要layer配置一次即可持续生效 - macOS阴影的
shadowOffset是相对于视图坐标系的，而Windows的负边距是相对于整个窗口矩形，二者不能简单映射 - Linux下若用SDL或GLFW创建窗口，其内部可能已禁用WM装饰（如
SDL_WINDOW_BORDERLESS），此时即使调用X11协议也无效，需改用SDL_WINDOW_RESIZABLE并接受系统标题栏
跨平台阴影不是“写一次就能跑”，而是每个平台都要单独验证行为边界——尤其是窗口状态变更（最小化/全屏/缩放）后的阴影残留或丢失问题。
