如何分发带子包的Go二进制包？避免源码泄露

这个问题我之前也碰到过，核心原因是子包的二进制处理规则和顶层包完全一致——你得给每个要二进制分发的子包也加上//go:binary-only-package注释，同时确保分发的目录结构和包路径严格匹配。

问题根源 #

你之前只给顶层greet包加了注释，但子包greet/hi没加。Go编译main.go时，会发现greet/hi缺少二进制包的标识，就会自动去源码目录找文件，而你已经移除了源码，所以才会报“找不到包”的错误。

完整解决方案 #

1. 给所有需要二进制化的包（包括子包）添加注释 #

打开greet/greet.go和greet/hi/hi.go，在包声明package xxx之前添加//go:binary-only-package注释，这是二进制包的强制标识：

greet/hi/hi.go示例：

//go:binary-only-package
package hi

// 你的业务代码...

greet/greet.go示例：

//go:binary-only-package
package greet

// 你的业务代码...

注意：这个注释必须是文件的第一行有效内容（可以在它前面放版权注释，但不能有其他代码或空行插在它和包声明之间）。

2. 重新编译并安装所有包 #

执行命令重新编译所有包，确保每个包都生成对应的.a二进制文件：

go install -a ./...

执行完成后，检查$GOPATH/pkg/linux_amd64/demo目录：

• 顶层目录下有greet.a（对应demo/greet包）
• demo/greet子目录下有hi.a（对应demo/greet/hi包）

3. 正确分发二进制包 #

分发的时候，要把整个demo目录（包括里面的greet子目录和hi.a文件）从$GOPATH/pkg/linux_amd64/下复制出来打包。用户拿到后，只需要把这个demo目录放到他们自己的$GOPATH/pkg/[对应平台]/目录下（比如linux_amd64），不需要任何源码，就能正常导入demo/greet和demo/greet/hi了。

关键注意事项 #

• 平台兼容性：.a文件和平台/架构强绑定，比如linux_amd64下编译的包不能直接在darwin_arm64上使用，需要针对不同平台单独编译分发。
• Go版本一致性：尽量用相同版本的Go编译二进制包和用户的主程序，避免因Go版本差异导致的兼容性问题。
• 避免源码冲突：用户的$GOPATH/src目录下不要存在demo的源码，否则Go会优先使用源码而非你的二进制包。

内容的提问来源于stack exchange，提问作者Minusy