理解API导出需求
在go语言开发中，开发者有时需要获取某个包（package）所导出的所有公共api接口，例如函数、类型、变量等。这种需求可能源于多种场景：
- 代码分析与审计： 快速了解一个不熟悉的包提供了哪些功能。
- 文档生成： 自动提取API列表作为技术文档的一部分。
- 辅助IDE自动补全（特定场景）： 虽然现代Go IDE（如VS Code与gopls、GoLand）通常能动态提供精确的自动补全，但在某些特定脚本或离线分析场景下，生成一份静态API列表仍有其价值。
- 学习与探索： 系统性地查看Go标准库或第三方库的对外接口。
Go语言提供了一个内置的命令行工具go tool api，能够高效地满足这些需求。
go tool api工具详解
go tool api是Go工具链中的一个强大组件，用于报告指定Go包的API信息。它能够列出包中所有导出的（即首字母大写的）函数、类型、变量和常量，并显示它们的签名。
基本用法
使用go tool api非常简单，只需在命令行中指定要分析的包路径即可。例如，要查看fmt包的API：
go tool api fmt
执行上述命令后，您将看到fmt包导出的所有API列表，格式通常是pkg ,
立即学习“go语言免费学习笔记（深入）”；
示例输出（部分）：
pkg fmt, func Append(error) []byte
pkg fmt, func Appendf([]byte, string, ...interface{}) []byte
pkg fmt, func Appendln([]byte, ...interface{}) []byte
pkg fmt, type Error
pkg fmt, func Errorf(string, ...interface{}) error
pkg fmt, func Fprint(io.Writer, ...interface{}) (int, error)
pkg fmt, func Fprintf(io.Writer, string, ...interface{}) (int, error)
pkg fmt, func Fprintln(io.Writer, ...interface{}) (int, error)
...从输出中可以看出，它清晰地展示了fmt包中的函数（func）、类型（type）及其签名。
筛选与导出特定API类型
在实际应用中，我们可能只对特定类型的API感兴趣，例如只想要函数列表，或者只想将结果保存到文件中。结合命令行工具（如grep）和重定向操作符，可以轻松实现这些目标。
筛选特定API类型
如果您只想查看特定类型的API，例如所有导出的函数，可以使用grep命令进行过滤。以下示例展示如何获取runtime包中所有的导出函数：
go tool api runtime | grep func
示例输出（部分）：
pkg runtime, func Breakpoint() pkg runtime, func CPUProfile() []byte pkg runtime, func Caller(int) (uintptr, string, int, bool) pkg runtime, func Callers(int, []uintptr) int pkg runtime, func FuncForPC(uintptr) *Func pkg runtime, func GC() ...
同样，您也可以筛选其他类型的API，例如：
- 筛选类型：go tool api net | grep type
- 筛选变量：go tool api os | grep var
导出API列表到文件
要将go tool api的输出保存到文本文件中，可以使用标准的重定向操作符>。例如，将net包的所有API导出到net_api.txt文件：
go tool api net > net_api.txt
如果您只想导出net包中的函数列表到文件：
go tool api net | grep func > net_funcs.txt
这将创建一个名为net_api.txt或net_funcs.txt的文件，其中包含相应的API信息，每行一个API，方便后续查阅或处理。
进阶应用与注意事项
遍历多个包
对于需要获取多个包甚至所有Go模块中的API列表的场景，可以结合go list命令。go list可以列出Go工作区或模块中的所有包路径。
例如，列出所有标准库包的API（这会产生大量输出，请谨慎操作）：
go list std | xargs -L1 go tool api
或者，如果您只想获取所有模块中的所有包的API：
go list all | xargs -L1 go tool api
注意事项：
- go list all会列出当前项目依赖的所有包，输出量巨大。
- xargs -L1表示每次将一行输出作为参数传递给go tool api。
- 在实际操作中，通常会结合grep和文件重定向来筛选和保存结果。
与IDE自动补全的关系
正如开头所述，go tool api生成静态API列表与现代Go IDE的自动补全机制有所不同。现代IDE通常依赖语言服务器协议（LSP）实现，例如Go语言的gopls。gopls能够实时解析代码，提供上下文敏感的、动态的自动补全建议，而不仅仅是基于一个静态的API列表。
因此，如果您主要目的是改善IDE的自动补全体验，那么确保您的Go开发环境配置了最新的语言服务器（如gopls）并正常工作，通常是更直接和有效的解决方案。go tool api更多地是用于静态分析、文档生成或脚本处理等场景。
局限性
- go tool api只报告导出的（Exported）API，即名称首字母大写的公共接口。私有（未导出）的API不会被列出。
- 它主要针对Go包的编译时信息，不涉及运行时反射或动态行为。
总结
go tool api是Go语言工具链中一个简洁而强大的工具，它为开发者提供了一种标准化的方式来查询和分析Go包的公共API接口。无论是为了代码审计、生成文档，还是仅仅为了更好地理解Go包的结构，掌握go tool api的使用都能极大地提升开发效率。通过结合grep和文件重定向，您可以灵活地筛选和保存所需的API信息，从而更好地管理和利用Go语言的丰富生态。
