Go Development Stack — Go 开发栈

Go 开发栈（带观点的现代化 Go 开发配置） 每个关注点仅一个工具，零重叠。

适用场景

• 从零新建 Go 项目
• 引入 lint、format、测试基础设施
• 为 Go 服务或库配置 CI/CD
• 用 Justfile 替代 Makefile
• 添加数据库迁移工具
• 将分散的 gofmt/govet/staticcheck 调用统一为单一方案

工具栈 Tool Version Role 替代 Go 1.26+ 语言、工具链、go mod - golangci-lint v2.11+ 元 linter（100+ linter + fmt 命令） 单独运行的 gofmt、govet、staticcheck、errcheck gofumpt v0.9+ 严格格式化（gofmt 超集，17+ 额外规则） gofmt gotestsum v1.13+ 测试运行器（可读输出、watch 模式、JUnit XML） 原生 go test just latest 任务运行器 Makefile golang-migrate v4.19+ 数据库迁移（CLI + 库 + embed.FS） 手工 SQL 脚本

快速开始：新项目

• 创建模块

mkdir myapp && cd myapp go mod init github.com/yourorg/myapp

• 搭建目录

mkdir -p cmd/myapp internal migrations

• 安装工具

go install github.com/golangci/golangci-lint/v2/cmd/golangci-lint@latest go install mvdan.cc/gofumpt@latest go install gotest.tools/gotestsum@latest go install -tags 'postgres' github.com/golang-migrate/migrate/v4/cmd/migrate@latest

• Go 1.24+ 将工具写入 go.mod

go get -tool github.com/golangci/golangci-lint/v2/cmd/golangci-lint@latest go get -tool mvdan.cc/gofumpt@latest go get -tool gotest.tools/gotestsum@latest

• 创建配置文件（模板见下）
• 运行：just check

.golangci.yml 已给出 Justfile 已给出