Golang中cmd/go: go:binary-only-package在Go 1.10版本无法正常工作的问题讨论 #24318

在Go 1.10中，//go:binary-only-package注释要求二进制包必须包含准确的导入块，以便在链接时解析依赖关系。这意味着即使包是预编译的二进制形式，其源文件仍需包含完整的import声明，列出所有依赖包。

以下是一个示例，展示如何正确创建和使用二进制包：

首先，创建一个简单的包mypkg：

mypkg.go（源代码形式，用于生成二进制包）：

//go:binary-only-package

package mypkg

import (
    "fmt"
    "strings"
)

func Hello() {
    fmt.Println(strings.ToUpper("hello from binary package"))
}

使用以下命令编译该包为二进制形式（假设在Linux amd64环境）：

go build -o mypkg.a

现在，分发该包时，需要同时提供编译后的mypkg.a文件和包含准确导入块的源文件mypkg.go。注意源文件中的//go:binary-only-package注释告诉Go工具链不要重新编译此包，而是使用预编译的二进制文件。

在另一个程序中使用此二进制包：

main.go：

package main

import "mypkg"

func main() {
    mypkg.Hello()
}

确保二进制包文件mypkg.a位于适当的路径下，例如在$GOPATH/pkg/linux_amd64/目录中，或者通过-o标志指定路径。同时，包含导入块的源文件mypkg.go必须存在于$GOPATH/src/mypkg/目录中，即使它是空的（除了package声明和import块）。

关键点：

• 二进制包的源文件必须包含所有依赖包的准确import声明（如示例中的fmt和strings）。
• Go工具链在链接时会读取这些import块来解析依赖，但不会重新编译包。
• 如果import块不完整或错误，链接阶段将失败，提示缺少依赖。

此机制确保了二进制包在分发后仍能正确链接，而不需要完整的源代码。