Linux用notify-send最轻量但需安装libnotify，Windows用Shell_NotifyIcon需消息循环，macOS推荐osascript；跨平台需运行时检测依赖并设计降级链路。
Linux上用notify-send最轻量，但得装libnotify
大多数桌面环境（GNOME、KDE、XFCE）默认支持notify-send命令行工具，它背后调用的是D-Bus接口的org.freedesktop.Notifications服务。不用链接复杂库，C++里用std::system()或posix_spawn就能触发。
常见错误是直接运行notify-send却提示“command not found”——这不是代码问题，而是目标机器没装libnotify-bin（Debian/Ubuntu）或libnotify（Arch/Fedora）。检查方法：which notify-send；缺失时用包管理器安装即可。
实操建议：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
-
notify-send不阻塞主线程，适合快速弹出提示，但无法获取用户点击反馈 - 标题和正文需用单引号包裹并转义单引号，例如：
notify-send 'App' 'It'\''s ready!' - 加图标用
-i参数，路径必须是绝对路径或已注册的图标名（如dialog-information） - 超时毫秒数用
-t 3000，注意某些桌面环境会忽略该值（如GNOME 42+强制使用固定时长）
Windows上用Shell_NotifyIcon要处理消息循环和资源
Windows原生方案不是弹窗API，而是任务栏通知区域（tray icon）+ 气泡提示。核心是Shell_NotifyIcon函数，但必须满足两个前提：窗口句柄有效、且程序有消息循环（GetMessage/DispatchMessage）。
立即学习“C++免费学习笔记（深入）”；
容易踩的坑是直接在控制台程序里调用Shell_NotifyIcon却无反应——因为没有窗口，也没有MSG泵。解决方案要么创建隐藏窗口，要么改用ToastNotification（Windows 10/11），后者需要COM初始化+XML模板+后台任务注册，复杂度陡增。
实操建议：
- 用
NIM_ADD注册图标前，先调用CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED) -
NOTIFYICONDATA结构体中uFlags必须包含NIF_ICON | NIF_MESSAGE | NIF_TIP才能显示气泡 - 气泡文本限制约256字符，超出部分被截断，且不支持换行
- 图标资源需提前加载为
HICON，不能传文件路径；可用LoadIcon从exe资源或LoadImage从磁盘加载
macOS上osascript比NSUserNotification更简单可靠
macOS Catalina（10.15）起，NSUserNotification被标记为废弃，官方推荐用UserNotifications框架（需Objective-C++混编）。但对纯C++项目，调用AppleScript反而更稳：osascript -e 'display notification "msg" with title "title"'。
这个命令在所有现代macOS上都可用，无需额外依赖，也不用处理沙盒权限（NSUserNotification在沙盒应用中需配置entitlements）。唯一限制是无法自定义图标——系统固定用发起进程的图标。
实操建议：
- 双引号内嵌套单引号即可避免转义麻烦，例如：
osascript -e "display notification \"Done\" with title \"MyApp\"" - 若需声音提醒，加
sound name "Glass"（系统内置音效名，区分大小写） - 脚本执行失败时返回非零码，建议检查
std::system()返回值，而非只看输出 - 不要尝试用
fork+exec手动解析AppleScript语法——osascript本身足够健壮
跨平台封装要注意三件事：检测环境、降级策略、资源路径
别写“一套代码编译到三端”，而是按平台分发逻辑。检测不能只靠#ifdef _WIN32，还得运行时确认依赖是否存在（比如Linux下which notify-send失败就该fallback到console log）。
图标路径最容易出错：Windows要求HICON句柄，macOS自动取app图标，Linux的-i参数接受绝对路径或freedesktop图标名。统一用相对路径会导致Linux找不到文件、Windows加载失败。
实操建议：
- Linux下优先查
DISPLAY环境变量是否非空，再查notify-send是否存在，否则跳过 - Windows下用
IsWindows10OrGreater()判断是否值得引入Toast API；否则坚持用Shell_NotifyIcon - macOS上
osascript调用失败时，不要重试，直接退化为fprintf(stderr, ...)——GUI不可用时日志是唯一可靠通道 - 所有外部命令调用都应设超时（如
std::chrono::seconds(1)），防止notify-send卡死在D-Bus总线忙时
