
详解 go 项目结构及包命名规则
本人从事 java 开发,近期转学 go,对 go 项目结构和包命名规范有以下疑问:
1. 包命名规则
在 java 中,包名通常遵循 com.公司.项目 的命名规范。而在 go 中,似乎包名都是一级的,如 package config。这样会不会容易出现重复?若与引入的第三方库重名,该怎么做?
2. 项目目录结构
一般情况下,go 开发中的项目目录结构是怎样的?能否提供示例?
解答
1. 包命名规则
在 go 中,包名的确是一级的。但为了避免重名,使用以下方案:
- 对于内部包,使用域名反转语法,例如:github.com/my-company/my-project。
- 对于外部或第三方的包,在 import 语句中使用前缀,例如:my-company/my-project。
2. 项目目录结构
以下是一种常用的 go 项目目录结构示例:
my-project
├── .gitignore
└── src
├── const // 常量
├── richRS // 富媒体(字体、图片)
├── host // 网络
├── main // 入口
│ └── main.go
├── tool // 工具
├── login // 登录逻辑
│ └── register.go
│ └── register_test.go
└── go.mod名相同处理
如果在项目中遇到重名,可以使用以下方法:
- 本地包和第三方包重名:在 import 语句中使用前缀(如上示例中的 my-company/my-project)。
- 本地包内部重名:对于同级包之间的重名,可以使用子文件夹或包别名来区分。例如,可以将文件 register.go 放入子文件夹 auth 中,并在 import 语句中使用别名:import login/auth "auth"。










