将主包放在cmd/myapp子目录是否可行?Go项目布局与工具使用疑问
你的项目布局没问题,是对Go工具链的行为理解有偏差
首先可以放心,你采用的Ben Johnson的Standard Package Layout是完全符合Go社区最佳实践的——根目录的核心库包定义类型接口,cmd/存放可执行入口,internal/隔离内部私有代码,这个结构清晰且被很多生产级项目采用,布局本身没有问题。
你遇到的问题本质是对Go工具链处理库包和可执行包的逻辑不熟悉:
为什么根目录执行go build -v无输出?
根目录的myapp.go属于库包(package myapp),不是可执行包(只有声明package main的包会生成二进制文件)。go build针对库包时,只会执行编译检查(验证语法、依赖是否正确),不会生成任何可执行文件,所以没有输出是正常的——如果代码有错误,反而会报错提示。
go install和go get为什么看起来没效果?
go install在根目录运行时,会把myapp库安装到本地的模块缓存(或GOPATH/pkg目录,取决于是否启用Go Modules),但因为是库,不会生成可执行文件放到你的GOBIN目录,所以你看不到直接的二进制输出。如果加上-v参数,你应该能看到它编译并安装了gitlab.tld/username/myapp这个库的过程。go get -v gitlab.tld/username/myapp的作用是将这个模块拉取到本地模块缓存,供其他项目导入使用,同样不会生成可执行文件,所以你感觉“没效果”,但其实模块已经被正确下载到本地了。
正确的操作方式
要生成或安装你的可执行程序,需要针对cmd/myapp下的main包操作:
- 在根目录生成可执行文件到当前目录:
go build -o myapp ./cmd/myapp - 直接进入
cmd/myapp目录执行go build,会在该目录生成myapp二进制文件。 - 要将可执行文件安装到你的
GOBIN目录(方便全局调用):
执行后,你可以直接在终端输入go install ./cmd/myappmyapp运行程序。
新手补充提示
- 牢记:只有
package main的包会被编译为可执行文件,所有其他包都是库,仅用于被其他代码导入使用。 - 关于文档区分:优先参考Go官方的文档(比如用
go doc命令查看本地包文档,或者官方的Go Modules指南),第三方文档注意看是否适配当前的Go版本(现在Go Modules是标准依赖管理工具,尽量避开基于GOPATH旧模式的过时文档)。
内容的提问来源于stack exchange,提问作者awagner
相关产品推荐
相关产品推荐

