Go go tool nm 怎样按符号筛选编译产物

如果你拿到一个 Go 可执行文件，想确认某个函数是否被编译进去，go tool nm 是很直接的入口：它会读取目标文件、归档或可执行文件中的符号，并把每个符号按地址、类型、名称列出来。真正的“筛选”通常由 nm 的排序参数和外部的 grep、awk 完成。

官方文档：https://pkg.go.dev/cmd/nm

先把产物类型和三列输出读懂，再按符号名称、符号类型、大小或地址缩小范围。nm 能告诉你“有哪些符号”，但不负责解释函数内部的机器指令。

先读懂 nm 的三列输出

官方用法是 go tool nm [options] file...。默认每行有三个空格分隔的字段：十六进制地址、一个字符表示的符号类型、符号名称。代码段通常用大写 T 表示，静态代码段用小写 t；只读数据是 R/r，数据段是 D/d，BSS 是 B/b。

还有一个排查时很容易误读的类型：U 表示当前文件引用了但没有定义这个符号。它按照约定不显示地址，所以不要把空地址当成 nm 解析失败。

先记住一个实用判断：想找函数，优先看 T 或 t；想找全局数据，关注 D、d、B；看到 U，说明当前产物只保存了引用，定义可能在别的目标文件或链接阶段。

编译产物后按名称筛出目标符号

nm 读取的是已经存在的产物，因此第一步是准备一个可检查的二进制文件。下面的命令假定项目入口在 ./cmd/symbol-demo，把输出写入单独的 bin 目录，再用正则只保留目标名称。

# 先把 Go 程序编译为可检查的可执行文件
go build -o ./bin/symbol-demo ./cmd/symbol-demo

# -type 把类型追加到符号名后，-sort name 便于按名称定位
# grep 只做名称过滤，不改变 nm 对符号地址和类型的判断
go tool nm -type -sort name ./bin/symbol-demo | grep -E 'main\.(main|run)'

这里的关键是把职责分开：go tool nm 负责产生结构稳定的符号清单，grep 负责把人关心的名称留下。筛选不到目标时，先检查产物路径和正则，再确认目标函数没有被编译条件排除；不要直接把“没有匹配”理解成函数一定不存在。

按类型、大小和地址缩小范围

只按名称找不到线索时，可以改变输出维度。-type 会在名称后追加符号类型，-size 会把符号大小以十进制放在地址和类型之间；-sort 支持 address、name、none、size，其中 size 是从大到小排列。-n 是按地址排序的兼容别名。

这些命令适合回答不同问题：代码段筛选用于确认函数类符号，大尺寸排序用于发现体积较大的符号，地址排序用于观察链接产物中的位置关系。它们都只是静态清单，不等于函数执行顺序，也不提供反汇编内容。

几个容易混淆的边界

• 输入不是源码。nm 面向目标文件、归档和可执行文件；如果手里只有 .go 源码，应先构建或使用源码分析工具。
• 名称过滤不是符号类型过滤。grep 只匹配输出文本，类型判断要结合第二列，或使用 -type 让类型显式出现在名称后。
• 看不到名字不等于没有代码。目标可能被内联、裁剪，或者名称正则过窄；先放宽筛选，再结合构建参数判断。
• nm 不是反汇编器。它能告诉你地址、大小、类型和名称，不能代替反汇编、调试器或运行时剖析工具。

我在排查构建产物时通常按“先确认输入文件，再看三列，再按名称过滤，最后按类型/大小排序”的顺序走。这样可以把路径问题、正则问题和符号本身的问题分开，命令也更容易放进脚本中复用。

常见问题

为什么 go tool nm 输出里有些符号没有地址？

如果符号类型是 U，它表示当前文件引用了一个未定义符号。官方约定对这类符号省略地址，这属于输出语义，不是地址解析失败。

能不能只用 nm 找出某个函数占了多少空间？

可以先用 -size 显示符号大小，再用名称或类型过滤；但这个数字是符号层面的静态信息，不能直接等同于运行时内存占用，也不能替代完整的性能分析。

总结一下：先用默认输出确认地址、类型、名称三列，再用 -type、-size、-sort 选择观察维度，最后交给 grep 或 awk 做名称和类型筛选。只要保留“nm 负责列清单，外部命令负责过滤”的边界，排查编译产物会清楚很多。