SetWindowsHookEx 返回 0 表示钩子安装失败，而非未触发；常见原因包括宿主进程启用、hInstance 获取错误、非UI线程调用、未用低级钩子（WH_KEYBOARD_LL/WH_MOUSE_LL）或委托被GC回收。
为什么 SetWindowsHookEx 返回 0 就代表失败
在 C# 中调用 SetWindowsHookEx 后如果返回 0，说明钩子安装失败，**不是“没触发”，而是根本没挂上去**。常见原因包括：DLL 没导出 KeyboardProc 函数、托管代码地址不能直接传给系统、线程已退出导致钩子被自动卸载。
关键点是：全局钩子（WH_KEYBOARD_LL 除外）必须在**有消息循环的线程**中安装，且回调函数必须位于**非托管 DLL** 中——但 .NET 6+ 的 WH_KEYBOARD_LL 是例外，它允许托管代码直接处理，因为它是低级钩子，由系统在用户态调用，不跨进程注入。
-
WH_KEYBOARD（普通键盘钩子）必须用 C++ DLL 实现，C# 无法安全承载 -
WH_KEYBOARD_LL（低级键盘钩子）可直接在 C# 中定义静态回调函数，但必须标记为static且用UnmanagedCallersOnly（.NET 5+）或至少保证 GC 不回收委托 - 若使用
Marshal.GetFunctionPointerForDelegate获取委托指针，该委托对象必须长期存活（例如存为类字段），否则 GC 回收后指针失效，系统调用时崩溃
WH_KEYBOARD_LL 回调里怎么判断是按下还是释放
在 LowLevelKeyboardProc 回调中，通过 wParam 参数区分事件类型：WM_KEYDOWN（1）、WM_KEYUP（2）、WM_SYSKEYDOWN（260）、WM_SYSKEYUP（261）。注意：Alt+Tab、Alt+F4 等系统键会触发 WM_SYS* 消息，不是普通 WM_*。
同时，lParam 是指向 KBDLLHOOKSTRUCT 的指针，需用 Marshal.PtrToStructure 解析。其中 vkCode 是虚拟键码（如 VK_ESCAPE = 27），scanCode 是扫描码，flags 的第 7 位（0x80）为 1 表示是弹起事件（可用于辅助判断，但优先以 wParam 为准）。
private static IntPtr LowLevelKeyboardProc(int nCode, IntPtr wParam, IntPtr lParam)
{
if (nCode >= 0 && (wParam == (IntPtr)WM_KEYDOWN || wParam == (IntPtr)WM_SYSKEYDOWN))
{
var kbStruct = Marshal.PtrToStructure<kbdllhookstruct>(lParam);
Console.WriteLine($"Key down: {kbStruct.vkCode}");
}
return CallNextHookEx(_hookId, nCode, wParam, lParam);
}</kbdllhookstruct>
为什么按住 Ctrl+C 没触发，或者热键被拦截后程序无响应
全局钩子本身不会“吞掉”按键，除非你显式返回非零值（比如 return (IntPtr)1）。但若在回调中执行耗时操作（如 UI 更新、文件写入、网络请求），会阻塞系统消息分发，导致界面卡死、快捷键失灵，甚至 Windows 弹出“程序未响应”提示。
- 回调函数必须极快返回，所有业务逻辑应丢进线程池或发布到 UI 线程异步处理
- Ctrl+C 在多数编辑控件中属于“默认处理行为”，若你在钩子中返回了非零值，就等于告诉系统“这键我吃了”，后续控件收不到消息
- 调试时钩子可能干扰 Visual Studio 的快捷键（如 F5、Ctrl+Shift+B），建议先用简单键（如 F12、Insert）测试
- 管理员权限不是必须的，但若目标进程是高完整性级别（如以管理员运行的程序），而你的程序是中完整性，则某些键（尤其是系统热键）可能收不到
如何安全卸载钩子并避免内存泄漏
卸载钩子只靠 UnhookWindowsHookEx(_hookId) 不够——你还得确保回调委托没被 GC 回收，且卸载发生在同一线程（Windows 要求钩子必须由安装它的线程卸载）。
最稳妥的做法是：把回调委托声明为类的私有静态字段（防止 GC），在窗体关闭或服务停止时调用卸载，并检查返回值是否为 true；若程序异常退出，系统会自动清理钩子，但手动清理仍是必要习惯。
private static LowLevelKeyboardProc _proc = LowLevelKeyboardProc;
private static IntPtr _hookId = IntPtr.Zero;
<p>// 安装
_hookId = SetWindowsHookEx(WH_KEYBOARD_LL, _proc, GetModuleHandle(null), 0);</p><p>// 卸载（务必在同一线程调用）
if (_hookId != IntPtr.Zero)
{
UnhookWindowsHookEx(_hookId);
_hookId = IntPtr.Zero;
}</p>
容易被忽略的是：如果你在 WPF 或 WinForms 中注册钩子，却在 OnClosed 或 Dispose 里卸载，要确认此时线程仍有效（WinForms 主线程通常没问题，WPF 的 Dispatcher 可能已关闭）。
