C# WinForm如何监听Cursor.Current变化 排查等待光标卡住故障

为什么Control.CursorChanged无法监听到光标变化 #

Control.CursorChanged事件仅在单个控件的Control.Cursor属性被修改时触发，而你遇到的Cursors.WaitCursor切换是修改的全局静态属性Cursor.Current，不属于单个控件的属性变更，因此不会触发该事件。

全局光标变化监听方案 #

可以通过两种方式实现全局光标状态监听，前者实现简单适合临时排查，后者精度更高适合长期监控：

方案1：低侵入定时轮询（推荐用于临时排查） #

性能损耗可忽略，不需要修改自研库代码：

• 开启一个低频率UI线程定时器（建议间隔100ms即可）
• 每次触发时判断光标状态，命中等待光标时同步记录时间、调用栈、当前活跃窗口/控件等上下文信息
  示例代码：

// 初始化监控定时器
System.Windows.Forms.Timer cursorMonitorTimer = new System.Windows.Forms.Timer();
cursorMonitorTimer.Interval = 100;
cursorMonitorTimer.Tick += (s, e) =>
{
    if (Cursor.Current == Cursors.WaitCursor)
    {
        // 按需记录日志，附加调用栈、当前线程ID、活跃控件信息等定位用数据
        Debug.WriteLine($"[{DateTime.Now:HH:mm:ss.fff}] 检测到等待光标，调用栈：{Environment.StackTrace}");
    }
};
cursorMonitorTimer.Start();

方案2：捕获系统消息实现高精度监听 #

重写主窗体的WndProc方法，捕获系统光标变更消息WM_SETCURSOR实现实时监听：

private const int WM_SETCURSOR = 0x0020;
protected override void WndProc(ref Message m)
{
    if (m.Msg == WM_SETCURSOR && Cursor.Current == Cursors.WaitCursor)
    {
        // 记录上下文日志
    }
    base.WndProc(ref m);
}

根因排查&修复建议 #

绝大多数光标卡在等待状态的问题，都是光标恢复逻辑被异常中断导致，优先排查以下场景：

• 异步/多线程场景下耗时操作抛出未捕获异常，跳过了光标恢复的代码
• 光标切换逻辑没有配对，比如多次触发等待光标设置，仅执行了一次恢复操作
• 跨线程修改Cursor.Current属性，没有同步到UI线程导致状态异常

如果有权限修改自研库代码，推荐用IDisposable封装光标切换逻辑，确保无论是否抛出异常都能自动恢复光标：

public class WaitCursorScope : IDisposable
{
    private readonly Cursor _originalCursor;
    public WaitCursorScope()
    {
        _originalCursor = Cursor.Current;
        Cursor.Current = Cursors.WaitCursor;
    }
    public void Dispose()
    {
        Cursor.Current = _originalCursor;
    }
}

// 使用方式
using (new WaitCursorScope())
{
    // 执行耗时操作，无论是否抛出异常都会自动恢复光标
}

内容的提问来源于stack exchange，提问作者Flyrobot27