go 是编译型语言，源码注释不会被保留在二进制中，因此无法在运行时直接读取包注释——这与 python 的 `__doc__` 机制有本质区别。
在 Python 中，模块级文档字符串（如 """Program v1.0"""）会被解释器自动赋值给 __doc__ 变量，从而可在运行时直接访问。但 Go 没有等价的运行时反射机制来获取源码中的注释内容。Go 编译器在构建过程中会完全丢弃所有注释（包括包注释、函数注释、变量注释等），这些文本仅用于生成文档（如 go doc 或 godoc 工具）或静态分析，不会嵌入最终的可执行文件。
✅ 正确理解：
- go doc 命令能显示包注释，是因为它直接解析源码文件（.go 文件），而非读取已编译的二进制；
- runtime/debug.ReadBuildInfo() 可获取编译时注入的版本信息（如 vcs.revision, vcs.time），但不包含任何注释内容；
- reflect 包无法获取注释——Go 的反射系统不暴露源码元数据。
? 替代方案（需主动介入构建流程）：
若你确实需要在运行时“携带”包描述信息，推荐以下可靠实践：
-
使用 -ldflags 注入版本/描述字符串（推荐）
go build -ldflags "-X 'main.version=1.0' -X 'main.packageDesc=Program v1.0'" main.go
对应代码：
package main import "fmt" var ( version string packageDesc string // 将在链接时被填充 ) func main() { fmt.Println(packageDesc) // 输出: Program v1.0 } -
借助 go:generate + 自定义工具提取注释并生成常量
编写一个简单脚本（如用 go/parser 解析 package 块上方的注释），生成 doc_gen.go：//go:generate go run gen_doc.go package main const PackageComment = "Program v1.0"
⚠️ 注意事项：
- 不要尝试通过 os.Executable() 定位源码路径并读取 .go 文件——这既不可靠（生产环境通常无源码）、也不跨平台；
- 第三方库（如 github.com/rogpeppe/go-internal/godoc）可用于程序内解析源码，但需明确提供文件路径且依赖外部文件存在，不属于“从二进制内部获取”；
- 所有“运行时读取注释”的需求，本质上都需在构建阶段显式地将所需文本作为数据嵌入。
? 总结：Go 中不存在 __doc__ 的等价物。包注释是开发期和文档期的元信息，而非运行期数据。如需向用户暴露版本或描述，请通过构建参数或代码生成方式显式声明并注入，这是符合 Go 哲学的健壮做法。
