1. WM_SIZE 里等待光标卡住的现场SetCursor本身不复杂难的是它和SetCapture、ReleaseCapture、ShowCursor的调用顺序以及那句最容易被漏掉的「把旧 hCursor 存下来再恢复」。你看到的现象通常是拉伸一次窗口鼠标箭头变成沙漏窗口画完了沙漏却还在转除非把鼠标移出客户区再移回来光标才恢复正常。这篇文章就从Programming Windows里那段经典的WndProc出发把等待光标的设置与还原拆成可核对的动作。如果你手头没有顺手的模型通道可以先到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册、创建一把YOUR_API_KEY再在 Codex 里把 Base URL 指向https://taotoken.net/api让模型按LoadCursor→SetCapture→SetCursor→ReleaseCapture的顺序逐行陪你对照TaoToken 只负责把 Key 和兼容通道给你光标该由你的代码自己恢复。原始文章给出的四步是先HCURSOR hcur LoadCursor(...,...)拿到目标光标句柄再SetCapture(...)把鼠标捕获绑到窗口然后SetCursor(...)设置新光标最后ReleaseCapture()释放捕获。真正被忽略的是第五步——SetCursor会返回「上一个光标句柄」这个返回值必须留着等耗时操作做完再设回去。文章里那段WM_SIZE正是这么写的先用SetCursor(LoadCursor(NULL, IDC_WAIT))把等待光标装上同时把返回的旧句柄存进hCursor裁剪区算完以后再SetCursor(hCursor)还原。很多人抄代码时只抄了前半句把返回值丢掉于是沙漏就留在了屏幕上。还有一个更隐蔽的坑SetCursor设置的光标只在「窗口类没有注册光标」或「当前光标属于本窗口」时才稳定生效。鼠标如果停在别的窗口上系统会把光标换回去而SetCapture的作用就是先把鼠标事件临时锁到你的窗口上这样IDC_WAIT才不会被别的窗口抢走。ReleaseCapture则是归还这份临时占用顺序错了、或者中途return提前退出捕获没释放、旧光标没恢复两个问题会一起冒出来。下面按排查顺序来先说现象怎么复现再说用 TaoToken 接入的 Codex 怎么帮忙读这段代码然后是WndProc里的正确次序、可复制的核对方法最后是怎么在本地验证沙漏确实被换回来了。2. 先复现沙漏为什么只在 WM_SIZE 后不消失2.1 拉伸窗口触发 WM_SIZE 的完整链路WM_SIZE在窗口尺寸变化时被发送lParam的低位字是新的客户区宽度高位字是高度所以代码里才有cxClient LOWORD(lParam)和cyClient HIWORD(lParam)。这段处理里做的事不少删掉旧的裁剪区域、创建六个临时区域、用CombineRgn做并集和异或、删除临时对象最后才恢复光标。计算量本身不大但只要你在这中间调用了绘图或布局等待光标就有存在意义——它告诉用户「窗口在重排」。问题出在退出路径。WM_SIZE里有两次SetCursor第一次把等待光标装上并保存返回值第二次把旧句柄还原。如果第二次调用被跳过光标会停留在IDC_WAIT。常见跳过方式有三种在两次调用之间加了return把恢复逻辑挪到了某个条件分支里或者复制代码时只留下了SetCursor(LoadCursor(NULL, IDC_WAIT))根本没写恢复那一行。2.2 ShowCursor 与 SetCursor 别混为一谈原文里同时出现了ShowCursor(TRUE)和ShowCursor(FALSE)这两句和SetCursor是两套机制。ShowCursor维护的是一个内部显示计数TRUE加一、FALSE减一计数大于等于零时光标才显示。SetCursor换的是光标形状不改变显示计数。两者配合不当会出现「形状是箭头但看不见」或者「沙漏一直显示」的怪现象。排查时先确认自己想改的是形状还是显隐不要一边用SetCursor换形状一边用ShowCursor把计数越推越高。如果你把ShowCursor(TRUE)写在SetCursor之后、ShowCursor(FALSE)写在恢复之前看起来对称但计数是靠全局维护的任何一个分支少执行一次计数就再也回不到初始值。稳妥做法是只在真正需要隐藏时成对调用或者在窗口创建/销毁时集中处理而不是塞进每次WM_SIZE。2.3 复现步骤与观察点想稳定复现可以这样做运行程序后拖动窗口右下角持续改变大小松开鼠标的瞬间观察指针形状。如果它保持沙漏说明恢复那一句没执行到。再把鼠标移到客户区外如果形状自动变回箭头基本可以确认是SetCursor(hCursor)被跳过而不是系统层面的光标锁定。另一种复现方式是在WM_SIZE开头加一句临时日志把两次SetCursor的返回值打出来。第一次返回的是旧光标句柄第二次返回的是等待光标句柄两个值不同才说明顺序对了。若两次返回值相同往往意味着中间某次设置没生效或者窗口类注册时已经指定了固定光标把SetCursor的效果盖掉了。3. 用 TaoToken 接入的 Codex 逐行核对光标代码3.1 创建 Key 并把 Base URL 填成 https://taotoken.net/api打开 TaoToken 注册账号在控制台创建YOUR_API_KEY模型 ID 以模型广场当时列表为准不要凭记忆写不存在的名字。然后配置 Codex它用的是~/.codex/config.toml注意这里填的是 OpenAI 兼容风格的base_url不要把ANTHROPIC_*那套变量套上来model YOUR_MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY保存后把TAOTOKEN_API_KEYYOUR_API_KEY写进环境变量重启终端让 Codex 读到。base_url末尾不要加/v1这是最常见的 404 来源之一。配好之后可以先用一句简单的提问确认通道通了比如让 Codex 解释LOWORD和HIWORD在WM_SIZE里的作用能正常回答说明 Key 和地址都没问题。3.2 让 Codex 对照 LoadCursor→SetCapture→SetCursor→ReleaseCapture把WndProc里WM_SIZE那一段贴给 Codex要求它只做一件事按LoadCursor、SetCapture、SetCursor、ReleaseCapture四个调用点标出顺序并指出哪一句保存了旧光标、哪一句负责恢复。你可以这样描述任务逐行标注每次SetCursor的返回值去了哪里标出所有提前return的分支确认恢复语句是否可达检查SetCapture与ReleaseCapture是否成对出现指出ShowCursor的调用次数是否与初始状态匹配。Codex 会给出文字级的对照结果不会替你去调用SetCursor也不该去连你的编译环境执行任何东西。它做的是「读代码、找顺序、给判断」。真正的编译和运行在你的本地完成报错或异常现象再贴回对话继续追问。3.3 让模型解释返回值而不是替你执行SetCursor的返回值语义是「被替换掉的那个光标句柄」第一次调用时它可能是NULL窗口类光标也可能是类光标句柄。让 Codex 解释这一点时可以追问如果第一次返回NULL恢复时SetCursor(NULL)会发生什么答案是由系统按窗口类或默认箭头处理通常不会崩但形状可能与你预期不同。这个细节决定了你该不该无条件保存返回值。需要强调的是模型能给的是语义解释和顺序核对不会真的去操作你的窗口。任何「让 AI 直接跑起来看效果」的想法都要收住——编译、运行、观察光标这三步必须由你在本地完成。4. WndProc 里等待光标的正确次序4.1 WM_SIZE 开头保存旧 hCursor原文的写法是hCursor SetCursor(LoadCursor(NULL, IDC_WAIT))一行里完成了三件事加载等待光标、设置、保存旧句柄。展开写更清楚case WM_SIZE: cxClient LOWORD(lParam); cyClient HIWORD(lParam); /* 1. 加载等待光标并设置同时保存旧句柄 */ hCursor SetCursor(LoadCursor(NULL, IDC_WAIT));这里的hCursor必须是static或者至少活到恢复那一刻的变量。原文把它声明成局部HCURSOR hCursor因为在同一个case块内先设后恢复作用域够用。但如果你把恢复逻辑放到另一个消息处理里就必须提升为static否则句柄丢了恢复无从谈起。4.2 裁剪区计算完再 SetCursor(hCursor)中间那一段创建椭圆区域、用RGN_OR和RGN_XOR组合裁剪区属于纯计算不涉及光标。这一段越长等待光标越有意义。计算结束后原文紧接着写for (i 0; i 6; i) DeleteObject(hRgnTemp[i]); /* 2. 恢复旧光标 */ SetCursor(hCursor); ShowCursor(FALSE); return 0;注意SetCursor(hCursor)的位置在DeleteObject循环之后、return之前这是关键。只要在这两者之间插入任何一个return或break恢复就会被跳过。写的时候把恢复语句当作「本分支的唯一出口前的最后一件事」能避免大多数遗漏。4.3 SetCapture 与 ReleaseCapture 的配对检查原文四步里提到SetCapture和ReleaseCapture它们和光标是配套的。SetCapture把鼠标输入固定到当前窗口这样即使指针移出客户区IDC_WAIT也不会被别的窗口换走。ReleaseCapture归还这份捕获。检查配对时可以搜一遍代码每个SetCapture是否有对应的ReleaseCapture是否有分支在两者之间提前返回ReleaseCapture是否在恢复光标之前调用。如果捕获没释放后续的鼠标消息可能被错误地送到你的窗口表现为点击无响应或焦点异常。这类问题和沙漏不消失常常同时出现因为都源于「中途退出」。4.4 ShowCursor 计数与光标形状的关系把ShowCursor(TRUE)和ShowCursor(FALSE)放在WM_SIZE里是原文的做法但它的目的是临时隐藏不是必须。更稳的做法是确认真实需求是「隐藏指针」还是「换成沙漏」。如果只是想让用户知道忙SetCursor就够了不必动ShowCursor。一旦引入显示计数就要保证每个TRUE都有配对的FALSE并且不跨分支丢失。排查时可以在调试器里观察显示计数或者干脆把两句ShowCursor注释掉看沙漏是否仍然能正常恢复。如果去掉后问题消失说明问题在显示计数不在SetCursor。5. 在本地编译运行验证等待光标是否恢复5.1 断点观察两次 SetCursor 的返回值在SetCursor(LoadCursor(NULL, IDC_WAIT))和SetCursor(hCursor)两行各下一个断点运行后拉伸窗口。第一次停下时记录返回值第二次停下时确认参数正是第一次的返回值。两个值不同、且第二次传的是旧句柄说明逻辑正确。如果第二次传进去的是等待光标句柄本身那就是变量被覆盖了检查hCursor是否在中间被重新赋值。5.2 拖拽窗口时观察指针形状不用调试器也能验证运行程序持续拖动窗口边角改变大小。开始拖动的瞬间应出现等待光标松手后立刻恢复箭头。如果沙漏持续存在把鼠标移出客户区再移回若此时恢复说明是SetCursor(hCursor)没执行若移出也不恢复则可能是ShowCursor计数被推高需要查显隐逻辑。5.3 多显示器与光标热点带来的误判换了高 DPI 显示器后光标可能看起来「不太一样」容易被误认为是沙漏没恢复。实际排查时确认两点一是形状确实是沙漏还是只是缩放后的箭头二是热点位置是否偏移。把窗口拖到主显示器再试一次能排除大部分误判。真正确认逻辑问题时用断点看返回值比肉眼可靠。6. 排障几个和 SetCursor 相关的常见错法6.1 漏掉恢复那一次 SetCursor最典型的就是只写了设置、没写恢复。代码里搜SetCursor如果只有一处基本可以断定问题在这里。补上SetCursor(hCursor)并确保它在所有提前返回之前执行或者在return前统一走一个清理标签。6.2 顺序反了先 ReleaseCapture 再 SetCursor如果先释放捕获再恢复光标窗口失去捕获的瞬间系统可能按当前鼠标位置重新决定光标归属导致SetCursor(hCursor)的效果被覆盖。正确顺序是先把形状恢复再释放捕获或者至少在释放前完成恢复。这一条在原文的四步里没有强调但排障时很容易踩到。6.3 把 IDC_WAIT 写成了别的常量LoadCursor(NULL, IDC_WAIT)里第二个参数必须是IDC_WAIT写成IDC_ARROW就变成「设置箭头」看起来就像没生效写成不存在的常量则返回NULLSetCursor(NULL)会回退到默认光标。检查这一行时确认常量名拼写正确、头文件已包含。6.4 窗口类注册时固定了光标如果注册窗口类时hCursor字段填了具体句柄SetCursor仍然可以临时改变形状但某些情况下会被类的默认行为覆盖。排查时可以检查WNDCLASS或WNDCLASSEX的hCursor成员必要时先设为NULL让SetCursor完全接管形状。7. 配通通道之后回到控制台对一下这次调用Codex 那边确认通道可用后可以顺手回 TaoToken 模型对话 用同一把YOUR_API_KEY发一条测试消息确认模型 ID 和 Base URL 都对得上。要是你打算长期把 Codex 当成读 Win32 代码的搭子可以看看 Coding Plan 的额度是否够用Key 统一在 控制台 API Keys 创建和管理。回控制台对一次用量也能顺便确认刚才那些关于SetCursor的追问确实记在了这把 Key 上。光标这件事最后还是要落到你的调试器里。模型能帮你把LoadCursor→SetCapture→SetCursor→ReleaseCapture的顺序和返回值语义讲清楚能指出提前返回的分支但它不会替你按下 F5也不该去连你的机器执行任何东西。真正的验证只有一种在本地编译运行拉伸窗口盯着指针形状看它有没有从沙漏变回箭头。变回来了这段代码就算过关没变回来把断点处的返回值和分支走向贴回对话再让 Codex 陪你找那一句被跳过的SetCursor。