Go項(xiàng)目結(jié)構(gòu)雖無(wú)官方強(qiáng)制標(biāo)準(zhǔn)，但社區(qū)普遍採(cǎi)用以cmd、internal、pkg等目錄為核心的組織方式，1. cmd/存放主程序入口，每個(gè)可執(zhí)行文件對(duì)應(yīng)子目錄，main.go僅作初始化和啟動(dòng)服務(wù)；2. internal/存放私有業(yè)務(wù)邏輯，按handler、service、repository、model分層，確保代碼解耦且不可被外部引用；3. pkg/存放可被外部項(xiàng)目復(fù)用的公共庫(kù)；4. api/存放gRPC或OpenAPI的接口定義文件並支持版本管理；5. config/存放不同環(huán)境的配置文件，scripts/存放構(gòu)建、部署、遷移等自動(dòng)化腳本；6. deploy/包含Dockerfile和K8s部署清單，便於CI/CD集成；7. tests/可存放集成或端到端測(cè)試用例，區(qū)別於單元測(cè)試。該結(jié)構(gòu)適用於中大型項(xiàng)目，小型項(xiàng)目可簡(jiǎn)化為main.go加handler、service、model等基礎(chǔ)目錄，關(guān)鍵在於保持邏輯清晰、易於維護(hù)。

Go 項(xiàng)目結(jié)構(gòu)沒(méi)有官方強(qiáng)制標(biāo)準(zhǔn)，但社區(qū)廣泛採(cǎi)用一些約定俗成的組織方式，尤其是參考Go 官方開(kāi)源項(xiàng)目（如Kubernetes、Terraform）和Go 團(tuán)隊(duì)推薦的實(shí)踐。下面是一個(gè)典型的、適合中大型項(xiàng)目的Go 項(xiàng)目結(jié)構(gòu)示例，並解釋每個(gè)目錄的作用。

? 典型Go 項(xiàng)目結(jié)構(gòu)

my-project/
├── cmd/ # 主程序入口│ └── app/ # 如：cmd/app/main.go
│ └── main.go
├── internal/ # 私有業(yè)務(wù)邏輯，不對(duì)外暴露│ ├── handler/ # HTTP 處理器│ ├── service/ # 業(yè)務(wù)服務(wù)層│ ├── repository/ # 數(shù)據(jù)訪(fǎng)問(wèn)層（DB、緩存等）
│ ├── model/ # 數(shù)據(jù)結(jié)構(gòu)定義（如結(jié)構(gòu)體）
│ └── config/ # 配置解析與管理├── pkg/ # 可複用的公共庫(kù)（可被外部項(xiàng)目引用）
│ └── util/
│ └── logger.go
├── api/ # API 文檔或proto 文件（gRPC）
│ └── v1/
├── config/ # 配置文件（YAML、JSON 等）
│ └── config.yaml
├── scripts/ # 腳本：部署、構(gòu)建、數(shù)據(jù)庫(kù)遷移等│ ├── deploy.sh
│ └── migrate.sh
├── deploy/ # 部署相關(guān)：Dockerfile、K8s 清單等│ ├── Dockerfile
│ └── k8s/
├── tests/ # 外部測(cè)試腳本或集成測(cè)試用例│ └── integration_test.go
├── go.mod # Go 模塊定義├── go.sum # 依賴(lài)校驗(yàn)└── README.md

? 為什麼這樣組織？

1. cmd/ —— 程序入口

• 每個(gè)可執(zhí)行文件對(duì)應(yīng)一個(gè)子目錄（如cmd/api , cmd/worker ）。
• main.go在這裡，負(fù)責(zé)初始化依賴(lài)、啟動(dòng)服務(wù)。
• 保持main.go簡(jiǎn)潔，只做“膠水代碼”。

 // cmd/app/main.go
package main

import "my-project/internal/handler"

func main() {
    handler.StartServer()
}

2. internal/ —— 私有代碼

• 所有不希望被外部項(xiàng)目導(dǎo)入的代碼放在這裡。
• Go 語(yǔ)言原生支持： internal下的包不能被外部模塊import 。
• 按職責(zé)劃分目錄（類(lèi)似MVC 或Clean Architecture）：
  • model : 結(jié)構(gòu)體定義（如User、Post）
  • repository : 與數(shù)據(jù)庫(kù)交互（CRUD）
  • service : 業(yè)務(wù)邏輯（如創(chuàng)建用戶(hù)、發(fā)消息）
  • handler : HTTP 路由處理（對(duì)接Gin、Echo 等）

3. pkg/ —— 可複用公共包

• 存放可被其他項(xiàng)目引用的工具函數(shù)或通用組件。
• 例如： pkg/log , pkg/middleware , pkg/validator 。
• 注意：如果項(xiàng)目是庫(kù)（library）， pkg可能就是主目錄。

4. api/ —— 接口定義

• 如果使用gRPC 或OpenAPI，把.proto或.yaml文件放這裡。
• 版本化管理： api/v1/ , api/v2/
• 可配合生成代碼工具（如protoc）使用。

5. config/和scripts/

• config/ : 存放不同環(huán)境的配置文件（dev.yaml, prod.yaml）
• scripts/ : 自動(dòng)化腳本，比如：
  • 構(gòu)建鏡像
  • 數(shù)據(jù)庫(kù)遷移
  • 本地啟動(dòng)服務(wù)

6. deploy/ —— 部署相關(guān)

• Dockerfile : 容器鏡像構(gòu)建
• k8s/ : Kubernetes 部署清單（YAML）
• CI/CD 友好，便於自動(dòng)化發(fā)布

7. tests/ （可選）

• 雖然Go 測(cè)試通常用_test.go文件和go test ，但複雜集成測(cè)試可放這裡。
• 或者使用e2e/目錄專(zhuān)門(mén)做端到端測(cè)試。

?? 注意事項(xiàng)

• 不要濫用pkg/ ：不是所有代碼都該扔進(jìn)pkg 。只有真正通用、可複用的才放。
• 避免“大泥球”結(jié)構(gòu)：不要把所有.go文件堆在根目錄。
• 合理分層： handler → service → repository是常見(jiàn)模式，有助於解耦。
• 模塊名清晰： go.mod中模塊名建議用域名反寫(xiě)，如github.com/yourname/my-project

? 小型項(xiàng)目簡(jiǎn)化版

如果你只是做個(gè)簡(jiǎn)單的Web 服務(wù)或CLI 工具，可以簡(jiǎn)化：

 simple-api/
├── main.go
├── handler/
├── service/
├── model/
├── go.mod
└── README.md

只要邏輯清晰、易於維護(hù)，小項(xiàng)目不必過(guò)度設(shè)計(jì)。

基本上就這些。 Go 的項(xiàng)目結(jié)構(gòu)重在清晰、可維護(hù)、符合直覺(jué)，不需要復(fù)雜框架也能寫(xiě)出高質(zhì)量代碼。

以上是以示例項(xiàng)目結(jié)構(gòu)進(jìn)行的詳細(xì)內(nèi)容。更多資訊請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！