Windows下Go程序调用自定义DLL编译成功，仅同目录放DLL才可运行求助

我太懂这个问题了！之前帮好几个做Go+Windows DLL开发的朋友踩过这个坑——核心原因就是编译时的链接路径和运行时Windows查找DLL的规则不匹配：

你在cgo里设置的CFLAGS和LDFLAGS只是告诉Go的链接器："编译时去lib文件夹找头文件和DLL来完成链接"，但程序运行时，Windows会按照自己的DLL搜索顺序找文件，默认根本不会扫描你同级的lib目录，所以才会抛出"未找到"的错误。

下面给你几个实用的解决方案，按你的使用场景选就行：

方案1：临时/永久把lib目录加入系统PATH（快速调试用） #

这是开发阶段最省事的办法：

• 临时生效（仅当前命令行窗口）：打开命令提示符，切换到你的项目根目录，执行：

  set PATH=%PATH%;%cd%\lib
  

  之后再运行生成的exe就能正常加载DLL了，关闭窗口后PATH会恢复原状。
• 永久生效：右键「此电脑」→属性→高级系统设置→环境变量，在系统变量的PATH里添加你的lib文件夹绝对路径（比如C:\your-go-project\lib）。
  注意：永久修改PATH会影响全局，如果你有多个项目用不同版本的同名DLL，可能会出现冲突，开发环境更推荐临时方式。

方案2：在Go代码中动态指定DLL搜索路径（推荐生产/长期开发用） #

通过调用Windows系统APISetDllDirectoryW，让程序启动时告诉Windows："先去我的lib目录找DLL"，不用改环境变量，也不用移动文件。具体代码如下：

package main

import (
    "path/filepath"
    "syscall"
)

func init() {
    // 获取当前exe所在的目录
    exePath, err := syscall.Executable()
    if err != nil {
        panic("获取程序路径失败: " + err.Error())
    }
    // 拼接出lib文件夹的绝对路径
    libDir := filepath.Dir(exePath) + "\\lib"
    // 调用Windows API设置DLL搜索目录
    syscall.SetDllDirectoryW(syscall.StringToUTF16Ptr(libDir))
}

// 你的其他代码...

这样不管你把exe放到哪里，只要lib文件夹和exe同级，程序就能自动找到DLL，完美匹配你的目录结构。

方案3：运行时直接指定DLL绝对路径（最可靠的生产方案） #

如果你的DLL是动态加载的（不是编译时通过cgo静态链接的），可以直接用syscall.LoadLibrary指定完整路径，完全绕过Windows的默认搜索规则：

package main

import (
    "path/filepath"
    "syscall"
)

func main() {
    exePath, err := syscall.Executable()
    if err != nil {
        panic(err)
    }
    // 拼接DLL的绝对路径
    dllPath := filepath.Dir(exePath) + "\\lib\\libkeyboard.dll"
    // 加载指定路径的DLL
    dllHandle, err := syscall.LoadLibrary(dllPath)
    if err != nil {
        panic("加载DLL失败: " + err.Error())
    }
    defer syscall.FreeLibrary(dllHandle)

    // 后续获取函数地址、调用函数的逻辑...
}

这种方式没有任何依赖，是生产环境部署最稳妥的选择。

方案4：用MinGW链接器设置延迟加载（适合复杂场景） #

如果你用MinGW作为Go的C工具链，可以在cgo的LDFLAGS里添加延迟加载参数，配合方案2的路径设置使用：

/*
#cgo LDFLAGS: -L./lib -lkeyboard -Wl,--delay-load=libkeyboard.dll -Wl,--enable-auto-import
*/
import "C"

延迟加载会让程序在实际调用DLL函数时才去加载文件，这时再通过SetDllDirectory指定路径就能生效，不过这个方案相对复杂，一般优先选方案2或3。

内容的提问来源于stack exchange，提问作者Nikhil Varma