go 的 cgo 不支持传统相对路径（如 `./lib`）用于 `#cgo ldflags: -l`，因其链接阶段工作目录已变更；推荐使用 `${srcdir}` 变量（go 1.5+ 原生支持）或 `cgo_ldflags` 环境变量实现可移植静态库链接。

在 Go 项目中通过 cgo 链接本地静态库（如 libtest.a）时，若硬编码绝对路径（如 -L /home/user/project/src/testserver），会导致项目无法跨机器或不同工作目录构建，严重损害可移植性。根本原因在于：#cgo LDFLAGS 指令中的路径是在编译器预处理阶段解析的，而链接器实际执行时的工作目录可能已是 $GOROOT 或临时构建目录，导致相对路径（如 -L ./testserver）失效——链接器始终在错误路径下查找 -ltest，故报错 cannot find -ltest。

✅ 正确方案：使用 ${SRCDIR}（推荐，Go 1.5+）

Go 自 1.5 版本起原生支持 ${SRCDIR} 占位符，它会在构建时自动替换为当前 Go 源文件所在目录的绝对路径，兼具可读性与可移植性。修改 test.go 中的 cgo 指令如下：

// #cgo LDFLAGS: -L ${SRCDIR} -ltest
// #include "test.h"
import "C"

✅ 优势：无需外部环境变量，路径逻辑清晰（libtest.a 与 test.go 同目录），go build / go install 均可直接运行，且完全跨平台、跨路径生效。

⚙️ 替代方案：CGO_LDFLAGS 环境变量（兼容旧版本）

若受限于 Go

# Linux/macOS
CGO_LDFLAGS="-L$(pwd)/src/testserver -ltest" go install testserver

# Windows (PowerShell)
$env:CGO_LDFLAGS="-L$(Get-Location)\src\testserver -ltest"; go install testserver

⚠️ 注意：此方式需每次构建显式设置，不适合 CI/CD 自动化，且易因路径拼写错误引入隐患。

? 补充建议与验证步骤

• 确保头文件路径一致：若 test.h 不在默认包含路径中，同步添加 #cgo CFLAGS: -I${SRCDIR}；
• 验证库存在性：构建前确认 libtest.a 位于 ${SRCDIR} 下（即与 test.go 同级），且符合目标平台 ABI（如 amd64/arm64）；
• 调试技巧：启用详细构建日志定位问题：

  go build -x -ldflags="-v" ./src/testserver

  观察 gcc 调用命令中 -L 参数是否已正确展开为绝对路径。

综上，${SRCDIR} 是现代 Go 项目链接本地静态库的标准化实践——它消除了路径硬编码，使项目真正“一次编写，随处构建”。请优先升级至 Go 1.5+ 并采用该方案。