在Windows桌面应用程序中，判断用户是否正在操作电脑是一个常见需求。无论是自动锁屏、防疲劳提醒，还是统计活跃时间，都需要知道系统已经空闲了多久。Windows提供了一组底层的Win32 API，其中GetLastInputInfo可以用来获取自系统启动以来最后一次键盘或鼠标输入发生的时间戳。Go语言虽然不是Windows原生开发语言，但通过syscall包依然可以方便地加载DLL并调用这些函数。本文将围绕这个API展开，详细介绍从原理到实战的完整过程。
GetLastInputInfo 的作用与系统空闲时间的计算
GetLastInputInfo 位于系统目录 C:\Windows\System32\user32.dll 中，它的作用是填充一个 LASTINPUTINFO 结构体，其中 dwTime 字段记录了最后一次输入事件发生时的系统滴答计数。这个滴答计数与 GetTickCount 或 GetTickCount64 返回值使用相同的基准，即自系统启动以来经过的毫秒数。因此，只需用当前滴答数减去 dwTime，就能得到用户已经空闲的毫秒数。
值得注意的是，输入事件包括键盘按键、鼠标移动和点击，但不同版本的Windows对触摸、手写笔等设备的处理可能略有差异。在大多数场景下，这个API已经足够可靠。它的优势在于调用开销极低，不需要监听全局钩子，也不要求管理员权限，普通用户权限即可正常调用。
使用该API时有一个关键点：必须先设置结构体的 cbSize 字段，告诉系统结构体的大小，否则调用会失败。这与许多Win32 API的约定一致，是初学者最容易忽略的地方。
在Go语言中加载DLL并准备函数签名
Go标准库中的 syscall 包提供了 NewLazyDLL 和 NewProc 两个方法，可以延迟加载DLL并获取函数地址。对于 GetLastInputInfo，首先需要加载 user32.dll，然后声明对应的函数变量。另一个更现代的选择是使用 golang.org/x/sys/windows 包，它封装了常见Windows类型和函数，代码更简洁，也减少了手动处理 uintptr 的风险。
如果选择标准库 syscall，需要导入 unsafe 包来传递结构体指针。调用 syscall.Proc.Call 时，所有参数都是 uintptr 类型，返回值为三个 uintptr，其中第一个是函数返回值，第三个是错误码。这种风格与C语言调用Win32 API非常相似，但也需要开发者小心处理指针和整数转换。
下面给出两种方式的对比。标准库方式不依赖外部包，适合简单场景；x/sys/windows 方式更加健壮，并且直接提供了 GetTickCount64 函数，避免了手动加载 kernel32.dll 的麻烦。
完整代码示例与逐行解析
这里使用 golang.org/x/sys/windows 包来实现一个完整的 getSystemIdleTime 函数。首先安装依赖：
go get golang.org/x/sys/windows
然后编写如下Go代码：
package main
import (
"fmt"
"time"
"unsafe"
"golang.org/x/sys/windows"
)
var (
user32 = windows.NewLazySystemDLL("user32.dll")
procGetLastInputInfo = user32.NewProc("GetLastInputInfo")
)
type lastInputInfo struct {
cbSize uint32
dwTime uint32
}
func getSystemIdleTime() (time.Duration, error) {
var lii lastInputInfo
lii.cbSize = uint32(unsafe.Sizeof(lii))
r1, _, err := procGetLastInputInfo.Call(uintptr(unsafe.Pointer(&lii)))
if r1 == 0 {
return 0, err
}
now := windows.GetTickCount64()
idle := now - uint64(lii.dwTime)
return time.Duration(idle) * time.Millisecond, nil
}
func main() {
idle, err := getSystemIdleTime()
if err != nil {
fmt.Println("获取空闲时间失败:", err)
return
}
fmt.Printf("系统已空闲: %v\n", idle)
}代码首先通过 windows.NewLazySystemDLL 加载 user32.dll，并用 NewProc 获取 GetLastInputInfo 的地址。lastInputInfo 结构体与Win32中的 LASTINPUTINFO 布局一致，两个 uint32 字段分别在32位和64位系统上都是8字节大小，跨平台兼容。
调用时，unsafe.Pointer(&lii) 被转换为 uintptr 传入API。函数成功返回非零值后，利用 windows.GetTickCount64() 获取当前滴答数，两者相减得到空闲毫秒数，最后转换为 time.Duration 类型，方便Go程序后续使用。
需要注意的是，windows.GetTickCount64 返回 uint64，而 dwTime 是 uint32，相减前需要将 dwTime 转为 uint64，否则在存在溢出的情况下计算结果会出错。虽然系统连续运行超过49.7天才会遇到，但使用 GetTickCount64 可以从根本上避免这个问题。
调用中的常见错误与细节优化
第一个常见错误是忘记设置 cbSize。如果不初始化这个字段，GetLastInputInfo 会返回失败，错误码通常为 ERROR_INVALID_PARAMETER。第二个常见问题是结构体定义错误，例如把 dwTime 写成 uint64，这会导致API写入越界，引发不可预料的行为。务必保持字段类型与Win32头文件一致。
第三个问题是直接使用 GetTickCount 而不是 GetTickCount64。前者返回 uint32，在系统运行超过大约49.7天后会回绕到0，导致空闲时间计算出负值或巨大错误。虽然大部分桌面电脑不会连续运行那么久，但作为健壮的代码，还是建议使用64位版本。
另外，调用 procGetLastInputInfo.Call 时返回的错误值 err 是 syscall.Errno 类型，即使函数成功返回非零，err 也可能不为 nil（通常为 ERROR_SUCCESS 的零值）。因此判断成功与否应基于第一个返回值 r1，而不是 err。代码中已经体现了这一点。
实际应用场景与定时检测示例
获取系统空闲时间最直接的应用是自动锁屏。例如当空闲时间超过5分钟时，触发锁定或执行其他安全操作。下面演示如何结合 time.Ticker 每秒检查一次：
package main
import (
"fmt"
"time"
)
func watchIdle(threshold time.Duration) {
ticker := time.NewTicker(1 * time.Second)
defer ticker.Stop()
for range ticker.C {
idle, err := getSystemIdleTime()
if err != nil {
fmt.Println("检测出错:", err)
continue
}
if idle >= threshold {
fmt.Println("用户已离开，执行锁定操作")
// 这里调用锁屏或其他逻辑
}
}
}这段代码中，getSystemIdleTime 函数直接复用前文实现。time.NewTicker 每秒触发一次检查，当空闲时间达到阈值时执行相应动作。实际项目中还可以结合防抖机制，避免在临界点频繁触发。
另一个典型场景是统计用户活跃时间。可以记录每次从空闲变为活跃的时间点，将活跃时段累加起来。由于 GetLastInputInfo 本身不产生事件通知，轮询仍是主要手段，但轮询间隔设为1秒已经足够满足大多数需求，对系统资源的消耗几乎可以忽略不计。
总结与注意事项
通过本文，我们完整走通了使用Go语言调用Windows API获取系统空闲时间的流程：加载 user32.dll、初始化 LASTINPUTINFO 结构体、调用 GetLastInputInfo、用 GetTickCount64 计算差值。整个过程代码量不大，但涉及不少细节，尤其是结构体布局和返回值判断。
实际开发中建议优先使用 golang.org/x/sys/windows 包，它提供了更友好的类型和封装，能够显著降低出错概率。如果项目不允许引入第三方依赖，标准库 syscall 也完全可行，但需要自行处理更多底层细节。最后提醒一点，GetLastInputInfo 获取的是物理输入设备的最后活动时间，如果程序通过 SendInput 模拟了输入，该时间也会被更新，因此在某些场景下需要额外注意。
Go语言Windows API系统空闲时间修改时间：2026-09-28 00:40:18