GO 教程

Go linker(go tool link)参数速查表

一、构建标识 / 版本 / 信息注入(最常用 ⭐⭐⭐)

参数说明常用
-B note设置 ELF Build ID / Mach-O UUID
-buildid id设置 Go build ID(-buildid=可禁用)⭐⭐
-X importpath.name=value向 string 变量注入值⭐⭐⭐
-pluginpath path设置 plugin 的完整路径⭐⭐

二、调试 / 符号 / DWARF(VSCode / dlv 重点 ⭐⭐⭐)

参数说明调试建议
-s去掉符号表❌ 调试别用
-w去掉 DWARF 调试信息❌ 调试别用
-compressdwarf压缩 DWARF(默认 true)⭐ 大工程可关
-randlayout随机函数布局
-k symbol跟踪字段符号

三、构建模式 / 插件 / C 交互(你关心的 ⭐⭐⭐)

参数说明备注
-buildmode构建模式(exe / c-shared / plugin)⭐⭐⭐
-linkmodeinternal / external⭐⭐
-extld指定外部 linker
-extldflags传递给外部 linker 的参数
-aslrWindows c-shared 启用 ASLR

四、性能 / 分析 / 运行时行为(中级 ⭐⭐)

参数说明
-race启用竞态检测
-msan内存检查(Linux)
-asanAddressSanitizer
-memprofilerateruntime.MemProfileRate
-cpuprofileCPU profile
-memprofile内存 profile

五、ELF / 系统级(Linux 为主,Windows 很少用)

参数说明
-r pathELF 动态库搜索路径
-bindnow立即绑定符号
-I linkerELF 动态 linker
-L dir库搜索路径
-d禁用动态可执行

六、调试 linker 自身(极少用)

参数说明
-v打印 link trace
-benchmark链接阶段性能
-benchmarkprofile链接阶段 profile
-dumpdep符号依赖图
-c调用图
-debugnosplitnosplit 调用图

七、兼容 / 旧参数(了解即可)

参数说明
-ano-op(已废弃)
-nno-op(已废弃)
-f忽略版本不匹配
-g禁用包数据检查
-h出错即停

最重要的 10 个(你现在真的会用的)

-X -s -w -buildid -buildmode -linkmode -extldflags -compressdwarf -race -pluginpath

给你一个「实战对照表」

🔹 VSCode / dlv 调试(推荐)

# 什么 ldflags 都不要 # VSCode 自动加: -gcflags=all=-N -l

🔹 发布版本(最经典)

-ldflags="-s -w -buildid="

🔹 插件 / 版本注入(强烈推荐)

-ldflags="-X myproject/core.Version=1.2.0 -X myproject/core.Mode=prod"

🔹 并发 / channel 排错

-race