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 < 1.5，可通过环境变量注入路径：
# 在项目根目录（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} | ≥ 1.5 | ⭐⭐⭐⭐⭐ | 极低 | ★★★★★ |
| CGO_LDFLAGS | 全版本 | ⭐⭐⭐⭐ | 中（需脚本/文档说明） | ★★★☆☆ |
现代 Go 项目应优先采用 ${SRCDIR} —— 它是官方为解决此问题而设计的标准机制，语义清晰、行为确定、无需额外工具链，真正实现“一次编写，随处构建”。
