全局鼠标钩子在C#中必须用SetWindowsHookEx配合WH_MOUSE_LL，因窗体级事件和消息过滤器仅处理本进程UI消息，无法捕获其他进程的原始硬件输入；WH_MOUSE_LL回调须为静态、StdCall调用约定，结构体需显式对齐，且句柄生命周期绑定创建线程。
全局鼠标钩子在 C# 中必须用 SetWindowsHookEx 配合 WH_MOUSE_LL，不能靠窗体级事件或消息过滤器替代——后者根本收不到其他进程的原始鼠标动作，比如桌面点击、资源管理器拖拽、甚至任务栏右键。
为什么 PreviewMouseDown 或 Application.AddMessageFilter 不行
这些机制只处理本进程已派发到消息队列的 UI 消息，而低级鼠标钩子捕获的是硬件层原始输入（WM_MOUSEMOVE、WM_LBUTTONDOWN 等），早于窗口消息路由。典型失效场景包括：
- 切到 Chrome 或 VS 编辑器时，
PreviewMouseDown完全静默 -
Application.AddMessageFilter收不到WM_NCLBUTTONDOWN（非客户区点击，如标题栏拖动） - 锁屏前的鼠标移动、Win+D 显示桌面过程中的鼠标事件，全部漏掉
WH_MOUSE_LL 回调函数必须满足的硬性条件
系统在调用你的回调时，会严格校验签名和线程上下文。不满足任一条件，钩子注册成功但永不触发，或直接崩溃：
- 回调方法必须是 静态，且标记
[UnmanagedFunctionPointer(CallingConvention.StdCall)] - 参数类型固定为
int nCode, IntPtr wParam, IntPtr lParam，不能加 ref/out 或泛型 - 结构体
MSLLHOOKSTRUCT必须用[StructLayout(LayoutKind.Sequential, Pack = 8)]显式对齐（x64 下字段偏移不同） - 回调内严禁调用
MessageBox.Show、Thread.Sleep、任何 UI 更新或阻塞 I/O；否则会导致系统鼠标卡顿甚至假死
如何安全获取鼠标坐标与按键状态
lParam 是指向 MSLLHOOKSTRUCT 的指针，需用 Marshal.PtrToStructure 解析，不能直接强转：
var mouseStruct = Marshal.PtrToStructure<MSLLHOOKSTRUCT>(lParam); int x = mouseStruct.pt.x; int y = mouseStruct.pt.y; bool isLeftDown = wParam == (IntPtr)WM_LBUTTONDOWN; bool isCtrlPressed = (mouseStruct.dwExtraInfo & 0x80000000) != 0; // 实际需查 GetKeyState(VK_CONTROL)
注意：dwExtraInfo 并非标准按键状态位，正确判断修饰键应调用 GetKeyState；pt 坐标是屏幕坐标，不是客户端坐标，无需转换。
钩子句柄泄漏与调试失灵的常见原因
钩子生命周期绑定到创建它的线程，而非整个进程。以下操作极易导致“注册成功但无响应”：
- 在 WinForms 主窗体的
Form_Load里注册钩子，但未确保该线程持续运行（如没启动Application.Run或线程提前退出） - Debug 模式下单步调试回调函数，系统因超时自动卸载钩子（Release 模式下无此问题）
- 程序异常退出未调用
UnhookWindowsHookEx，残留句柄导致下次注册返回 0 - 多个实例同时注册同一类型钩子，后注册者覆盖前者，但旧句柄未释放
最稳妥的做法：在 Program.cs 的主线程中注册，并用 AppDomain.CurrentDomain.ProcessExit + Application.ApplicationExit 双保险卸载；调试时避免在回调内设断点，改用日志输出验证触发。
