EnumWindows是获取顶层窗口最可靠方式，但需结合GetForegroundWindow判断活动状态，并通过IsWindowVisible、IsIconic、GetWindowTextLength等过滤有效窗口，注意UWP限制、权限问题及线程安全。
Windows平台下用EnumWindows遍历所有顶层窗口
直接调用EnumWindows是获取活动窗口句柄最可靠的方式，它会枚举当前桌面所有顶层窗口（包括最小化、后台、无标题栏的窗口），但不保证“活动”状态——所谓“活动窗口”在Win32中实际指拥有输入焦点的窗口，需额外用GetForegroundWindow判断。
常见错误是只调用IsWindowVisible就认为是“活动窗口”，其实很多系统托盘窗口、后台工具窗口也可见但非活动；更稳妥的做法是先枚举全部顶层窗口，再逐个检查IsWindowVisible + IsIconic（排除最小化）+ GetWindowTextLength > 0（确保有标题）。
- 回调函数必须为
BOOL CALLBACK类型，且参数顺序不能错：HWND hwnd, LPARAM lParam -
lParam建议传入std::vector<:pair std::string>>*</:pair>指针，避免全局变量或静态容器带来的线程/重入风险 - 某些UWP窗口（如设置、邮件）可能无法通过此方式获取标题，这是系统限制，不是代码问题
用GetWindowText安全读取窗口标题
GetWindowText容易因缓冲区不足导致截断或崩溃，尤其遇到含Unicode字符（如中文、emoji）的标题时。必须先调用GetWindowTextLength获取真实长度，再分配足够空间（注意：长度不含结尾\0，所以缓冲区大小 = length + 1）。
另一个坑是窗口句柄可能在回调中已被销毁（比如用户刚好关闭了某个窗口），所以每次读取前务必用IsWindow(hwnd)验证有效性。
立即学习“C++免费学习笔记（深入）”；
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
- 不要用固定大小数组（如
char buf[256]），改用std::vector<wchar_t></wchar_t>动态分配 - 推荐统一用宽字符版本
GetWindowTextW，避免ANSI编码乱码 - 如果
GetWindowTextLength返回0，不代表没标题——可能是权限受限（如系统进程窗口）或窗口本身无文本，应跳过而非报错
过滤掉非用户窗口和系统窗口
原始枚举结果包含大量系统内部窗口（如Progman、WorkerW、Shell_TrayWnd），它们没有用户交互意义，也不该出现在“活动窗口列表”中。关键过滤逻辑是结合GetWindowLong(hwnd, GWL_EXSTYLE)和GetWindowLong(hwnd, GWL_STYLE)。
真正需要保留的是：有WS_VISIBLE、无WS_EX_TOOLWINDOW、且父窗口为NULL（即顶层窗口）的句柄。另外，可排除类名以#327开头的系统窗口（如#32768是桌面图标窗口）。
- 用
GetClassNameW获取类名比依赖标题更稳定，因为标题可能为空或动态变化 - 某些应用（如Electron）会创建多个嵌套
Chrome_WidgetWin_窗口，只需保留最外层那个（GetParent(hwnd) == NULL） - 不要用
IsHungAppWindow判断“卡死”，它不可靠且需要额外权限
C++实现时的内存与线程注意事项
回调函数里不能做耗时操作（如文件IO、网络请求），否则会阻塞系统枚举过程，导致部分窗口漏掉。所有数据收集必须轻量——只存HWND和标题字符串，后续处理放到主线程。
另一个常被忽略的问题是：如果程序以低完整性级别运行（如被UAC限制），将无法读取高完整性进程（如任务管理器、杀毒软件主窗口）的标题，GetWindowTextW会静默失败（返回0）。此时只能记录句柄，标题留空或标记为"[Access Denied]"。
- 避免在回调中调用
SendMessage或PostMessage，极易引发死锁 - 若需跨线程传递窗口列表，用
std::move转移std::vector，别拷贝大对象 - 调试时可用
spyxx.exe（Windows SDK自带）对照验证枚举结果是否完整
真正的难点不在枚举本身，而在如何定义“活动窗口”——用户视角的“正在用的窗口”和系统API的“前台窗口”常不一致；加上权限隔离、UWP沙箱、多桌面（虚拟桌面）等场景，一次枚举很难覆盖所有情况。实际项目中建议把基础枚举结果作为候选集，再叠加焦点、Z-order、最近交互时间等维度做二次筛选。
