go 的 cgo 不支持传统相对路径（如 `./lib`）作为 `-l` 参数，因其链接阶段工作目录与源文件位置不一致；推荐使用 `${srcdir}` 变量（go 1.5+ 原生支持）或 `cgo_ldflags` 环境变量实现可移植构建。

在 Go 项目中通过 CGO 链接静态库（如 libtest.a）时，若硬编码绝对路径（如 -L /home/test/testserver/src/testserver），会导致项目无法跨环境迁移。你可能会尝试改用相对路径：

// #cgo LDFLAGS: -L ./testserver -ltest
// #include "test.h"
import "C"

但执行 go install testserver 时会报错：cannot find -ltest。根本原因在于：CGO 在构建过程中会切换工作目录（例如进入 $GOPATH/pkg 或临时编译目录），此时 ./testserver 相对于当前工作目录已失效，而非源文件所在目录。

✅ 正确解决方案（推荐）

方案一：使用 ${SRCDIR}（Go 1.5 及以上，最简洁可靠）

${SRCDIR} 是 Go 内置的路径宏，在编译时自动替换为当前 .go 源文件所在目录的绝对路径，完全规避相对路径歧义：

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

✅ 优势：

• 无需外部环境变量，零配置；
• 路径精准指向 test.go 所在目录（即 src/testserver/），libtest.a 和 test.h 均可直接放在此目录下；
• 完全可移植：无论 go install 从项目根目录、src/ 下或任意路径执行，均能正确解析。

? 注意：确保 libtest.a 与 test.go 处于同一目录（本例中为 src/testserver/），否则需调整 ${SRCDIR} 后缀，例如 -L ${SRCDIR}/../lib。

方案二：使用 CGO_LDFLAGS 环境变量（兼容旧版 Go）

若受限于 Go

# 在项目根目录（testserver/）下执行
export CGO_LDFLAGS="-L $(pwd)/src/testserver -ltest"
go install testserver

或写入构建脚本以提升可复现性：

#!/bin/bash
ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
export CGO_LDFLAGS="-L ${ROOT_DIR}/src/testserver -ltest"
go install testserver

⚠️ 注意事项：

• CGO_LDFLAGS 会影响整个构建过程中的所有 CGO 包，若项目含多个依赖 C 库的包，需统一管理；
• 避免在 .bashrc 等全局配置中永久设置，防止污染其他项目。

? 错误实践警示

• ❌ 不要使用 ../ 或 ./ 等 shell 风格相对路径：CGO 解析器不执行 shell 展开，且工作目录不可控；
• ❌ 不要依赖 os.Getwd() 或构建时 pwd 输出硬编码到源码中：破坏声明式构建原则，易出错；
• ❌ 避免将 .a 文件移至系统标准路径（如 /usr/lib）：丧失项目自包含性，违反最小依赖原则。

总结

现代 Go 项目应优先采用 ${SRCDIR} —— 它是官方为解决此问题而设计的标准机制，语义清晰、行为确定、无需额外工具链，真正实现“一次编写，随处构建”。