详解 go 项目结构及包命名规则

本人从事 java 开发，近期转学 go，对 go 项目结构和包命名规范有以下疑问：

1. 包命名规则

在 java 中，包名通常遵循 com.公司.项目 的命名规范。而在 go 中，似乎包名都是一级的，如 package config。这样会不会容易出现重复？若与引入的第三方库重名，该怎么做？

2. 项目目录结构

一般情况下，go 开发中的项目目录结构是怎样的？能否提供示例？

解答

openclaw-gitcode-pr-monitor

监控一个或多个 GitCode 仓库的 PR，通过 OpenClaw Gateway 自动执行 AI 审查，发布 PR 评论，并发送钉钉和企业微信通知。

下载

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"。