本文介绍在 Go 语言中基于 Windows API 实现“按名称查找进程 PID”的完整方案，利用 CreateToolhelp32Snapshot 遍历系统进程快照，并匹配可执行文件名，支持大小写不敏感查找。
本文介绍在 go 语言中基于 windows api 实现“按名称查找进程 pid”的完整方案，利用 `createtoolhelp32snapshot` 遍历系统进程快照，并匹配可执行文件名，支持大小写不敏感查找。
在 Windows 平台上，Go 标准库仅提供 os.FindProcess(pid) 这类“由 PID 查进程”的接口，但不支持直接通过进程名（如 "notepad.exe"）反查 PID。要实现该功能，必须调用底层 Windows API —— 具体而言，需借助 Toolhelp32 系列函数构建进程快照并逐项遍历。
核心步骤如下：
- 调用 CreateToolhelp32Snapshot(TH32CS_SNAPPROCESS, 0) 创建当前系统所有进程的快照；
- 使用 Process32First 获取首个进程条目；
- 循环调用 Process32Next 遍历后续进程，直至返回 ERROR_NO_MORE_FILES；
- 对每个 ProcessEntry32 结构体中的 ExeFile 字段（UTF-16 编码的 C 字符串）进行安全解码，并与目标进程名（忽略大小写）比对。
以下为可直接运行的 Go 示例代码（需导入 golang.org/x/sys/windows 和 syscall）：
package main
import (
"strings"
"syscall"
"unsafe"
"golang.org/x/sys/windows"
)
const TH32CS_SNAPPROCESS = 0x00000002
type WindowsProcess struct {
ProcessID int
ParentProcessID int
Exe string
}
func GetProcesses() ([]WindowsProcess, error) {
handle, err := windows.CreateToolhelp32Snapshot(TH32CS_SNAPPROCESS, 0)
if err != nil {
return nil, err
}
defer windows.CloseHandle(handle)
var entry windows.ProcessEntry32
entry.Size = uint32(unsafe.Sizeof(entry))
if err = windows.Process32First(handle, &entry); err != nil {
return nil, err
}
var results []WindowsProcess
for {
results = append(results, newWindowsProcess(&entry))
err = windows.Process32Next(handle, &entry)
if err != nil {
if err == syscall.ERROR_NO_MORE_FILES {
break
}
return nil, err
}
}
return results, nil
}
func FindProcessByName(processes []WindowsProcess, name string) *WindowsProcess {
lowerName := strings.ToLower(name)
for _, p := range processes {
if strings.ToLower(p.Exe) == lowerName {
return &p
}
}
return nil
}
func newWindowsProcess(e *windows.ProcessEntry32) WindowsProcess {
// 安全截取 ExeFile 中以 \x00 结尾的有效 UTF-16 字节序列
end := 0
for end < len(e.ExeFile) && e.ExeFile[end] != 0 {
end++
}
exe := syscall.UTF16ToString(e.ExeFile[:end])
return WindowsProcess{
ProcessID: int(e.ProcessID),
ParentProcessID: int(e.ParentProcessID),
Exe: exe,
}
}
// 使用示例
func main() {
ps, err := GetProcesses()
if err != nil {
panic(err)
}
if p := FindProcessByName(ps, "notepad.exe"); p != nil {
println("Found notepad.exe with PID:", p.ProcessID)
} else {
println("notepad.exe not running")
}
}⚠️ 注意事项：
- 该方法返回的是进程的映像名称（Image Name），即 ExeFile 字段，通常为 chrome.exe、svchost.exe 等，而非完整路径或显示名称；
- 若需精确匹配（如区分多个同名进程），建议结合 ParentProcessID 或命令行参数（需额外调用 NtQueryInformationProcess + ProcessCommandLineInformation）；
- 程序需以普通权限运行即可获取大多数用户进程 PID；若需系统级进程（如 lsass.exe），可能需要提升权限或启用调试特权；
- syscall.UTF16ToString 在遇到非法 UTF-16 序列时可能 panic，生产环境建议使用更健壮的解码逻辑（如 golang.org/x/text/encoding/unicode）。
综上，虽然 Go 原生不支持“按名查 PID”，但通过封装 Windows Toolhelp API，我们能高效、可靠地实现该功能，适用于进程监控、自动化测试、资源清理等典型场景。
