Go调用Windows API函数的最佳实践及错误处理方案咨询

在Go中调用Windows API时，核心矛盾在于Windows的GetLastError错误机制和Go的error返回模式不匹配，解决这个问题的关键是严格遵循Windows API的约定，以API返回值判断成败，仅在失败时处理错误。针对你的GlobalMemoryStatusEx调用场景，具体实践如下：

核心原则 #

• 优先以API返回值判断成功/失败：Windows API几乎都用明确的返回值（如TRUE/FALSE）标识成败，这是判断的唯一依据，而非proc.Call返回的err。
• 仅在失败时处理错误：proc.Call返回的第三个err参数，本质是调用时的GetLastError()结果——无论API成功与否，它都会被填充。成功时的err（如"操作完成成功"）无实际意义，直接忽略并设为nil即可；只有API返回失败时，这个err才是有效的错误信息。

修改后的规范代码 #

package main

import (
    "fmt"
    "syscall"
    "unsafe"
)

// Windows MEMORYSTATUSEX structure（与系统定义严格对齐）
type MemoryStatusEx struct {
    dwLength                uint32
    dwMemoryLoad            uint32
    ullTotalPhys            uint64
    ullAvailPhys            uint64
    ullTotalPageFile        uint64
    ullAvailPageFile        uint64
    ullTotalVirtual         uint64
    ullAvailVirtual         uint64
    ullAvailExtendedVirtual uint64
}

type MemInfo struct {
    MemTotal uint64
    MemFree  uint64
    MemAvail uint64
}

func GetMemInfo() (minfo MemInfo, err error) {
    var winMemInfo MemoryStatusEx
    winMemInfo.dwLength = uint32(unsafe.Sizeof(winMemInfo))

    mod := syscall.NewLazyDLL("kernel32.dll")
    proc := mod.NewProc("GlobalMemoryStatusEx")

    // 调用API，获取返回值和错误信息
    ret, _, lastErr := proc.Call(uintptr(unsafe.Pointer(&winMemInfo)))
    
    // 第一步：以API返回值判断成败
    if ret == 0 {
        // 失败时，直接返回捕获的错误
        err = lastErr
        return
    }
    
    // 成功时，明确将err置为nil（符合Go的错误处理习惯）
    err = nil
    minfo.MemTotal = winMemInfo.ullTotalPhys
    minfo.MemFree = winMemInfo.ullTotalPhys - winMemInfo.ullAvailPhys
    minfo.MemAvail = winMemInfo.ullAvailPhys

    return
}

func main() {
    fmt.Println("testing GetMemInfo()")
    minfo, err := GetMemInfo()
    if err != nil {
        fmt.Println("Error getting memory info:", err)
        return
    }
    fmt.Printf("Memory: total %d, free %d, avail %d\n", minfo.MemTotal, minfo.MemFree, minfo.MemAvail)
}

额外注意事项 #

1. 不要手动调用syscall.GetLastError()：proc.Call已经帮你捕获了调用瞬间的GetLastError()结果，手动调用可能获取到其他操作的错误值，导致错误信息不准确。
2. 结构体对齐验证：确保自定义的Windows结构体（如MemoryStatusEx）和系统定义的内存布局一致。可以通过unsafe.Sizeof(winMemInfo)验证长度是否符合系统要求（MEMORYSTATUSEX在Windows中长度为64字节）。
3. 统一错误处理模式：所有Windows API调用都遵循这个模式，能让代码风格一致，也避免因错误处理不当导致的bug。

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