interview/questions/13-Golang语言/项目结构和工程化.md

Golang 项目结构和工程化

问题

1. Go 的标准项目结构是怎样的？
2. Go Module 是如何管理的？
3. Go 的依赖管理有哪些最佳实践？
4. 如何构建和发布 Go 应用？
5. Go 的 CI/CD 最佳实践是什么？

---

标准答案

1. 标准项目结构

Standard Go Project Layout

myapp/
├── cmd/                    # 主程序入口
│   └── myapp/
│       └── main.go
├── internal/              # 私有应用代码（不可导入）
│   ├── app/
│   ├── model/
│   └── service/
├── pkg/                   # 公共库（可外部导入）
│   └── util/
├── api/                   # API 协议定义
│   └── proto/
├── web/                   # Web 静态资源
├── configs/               # 配置文件
├── scripts/               # 构建、安装脚本
├── test/                  # 额外测试数据
├── docs/                  # 文档
├── tools/                 # 工具
├── go.mod
├── go.sum
├── Makefile
└── README.md

---

2. Go Module

初始化 Module

go mod init github.com/user/myapp

---

go.mod 文件

module github.com/user/myapp

go 1.21

require (
    github.com/gin-gonic/gin v1.9.1
    github.com/spf13/viper v1.18.2
)

---

3. 依赖管理

添加依赖

go get github.com/gin-gonic/gin@latest
go get github.com/spf13/viper@v1.18.2

---

升级依赖

# 升级所有依赖
go get -u ./...

# 升级特定依赖
go get -u github.com/gin-gonic/gin

---

清理未使用的依赖

go mod tidy

---

4. 构建和发布

构建应用

# 构建
go build -o bin/myapp ./cmd/myapp

# 交叉编译
GOOS=linux GOARCH=amd64 go build -o bin/myapp-linux ./cmd/myapp

---

Docker 多阶段构建

# 构建
FROM golang:1.21-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -o myapp ./cmd/myapp

# 运行
FROM alpine:latest
WORKDIR /root/
COPY --from=builder /app/myapp .
CMD ["./myapp"]

---

5. CI/CD 最佳实践

GitHub Actions

name: CI

on:
  push:
    branches: [ main ]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - name: Set up Go
        uses: actions/setup-go@v4
        with:
          go-version: '1.21'

      - name: Install dependencies
        run: go mod download

      - name: Run tests
        run: go test -v -race -coverprofile=coverage.out ./...

      - name: Upload coverage
        uses: codecov/codecov-action@v3
        with:
          files: ./coverage.out

---

6. 阿里 P7 加分项

深度理解：

• 理解 Go 的模块管理（Go Modules）
• 理解 Go 的依赖管理（go.mod、go.sum）
• 理解 Go 的构建和发布流程

实战经验：

• 有管理大型 Go 项目结构的经验
• 有设计 Go Module 依赖的经验
• 有构建和发布 Go 应用的经验

工程化：

• 理解如何组织 Go 项目结构
• 理解如何进行依赖管理
• 理解如何设置 CI/CD