💾 第20课：数据库操作GORM

Web开发第3阶段·第6/7课

📋 本课目标

掌握GORM基础CRUD
理解模型定义与迁移
掌握查询构建器
理解连接池配置

🔬 代码演示与验证

package main
import ("encoding/json";"fmt";"strings";"sync")
type DB struct{data map[string][]map[string]interface{};mu sync.RWMutex;aid int}
func NewDB()*DB{return &DB{data:make(map[string][]map[string]interface{})}}
func(d *DB)Create(t string,r map[string]interface{})map[string]interface{}{d.mu.Lock();d.aid++;r["id"]=d.aid;d.data[t]=append(d.data[t],r);d.mu.Unlock();return r}
func(d *DB)Find(t string)[]map[string]interface{}{d.mu.RLock();defer d.mu.RUnlock();return d.data[t]}
func(d *DB)First(t string,id int)(map[string]interface{},bool){d.mu.RLock();defer d.mu.RUnlock();for _,r:=range d.data[t]{if r["id"]==id{return r,true}};return nil,false}
func pj(label string,data interface{}){b,_:=json.MarshalIndent(data,"","  ");fmt.Printf("  %s: %s\n",label,string(b))}
func main() {
    db:=NewDB();db.data["users"]=[]map[string]interface{}{}
    fmt.Println("=== ORM操作 ===")
    u1:=db.Create("users",map[string]interface{}{"name":"张三","email":"z@ex.com","age":25})
    db.Create("users",map[string]interface{}{"name":"李四","email":"l@ex.com","age":30})
    pj("创建",u1);pj("查询全部",db.Find("users"))
    if u,ok:=db.First("users",1);ok{pj("查ID=1",u)}
    fmt.Println("\n=== GORM风格SQL ===")
    for _,q:=range []string{"SELECT * FROM users WHERE age > 25","INSERT INTO users (name,email) VALUES (?,?)","UPDATE users SET age = 26 WHERE id = 1"}{
        fmt.Printf("  %s\n",strings.Split(q," ")[0])
    }
    fmt.Println("\n=== 连接池 ===");fmt.Println("MaxOpen:100 MaxIdle:10 MaxLifetime:1h")
}

🔍 运行验证

✅ 验证通过 — 实机运行结果：

=== ORM操作 ===
  创建: {
  "age": 25,
  "email": "z@ex.com",
  "id": 1,
  "name": "张三"
}
  查询全部: [
  {
    "age": 25,
    "email": "z@ex.com",
    "id": 1,
    "name": "张三"
  },
  {
    "age": 30,
    "email": "l@ex.com",
    "id": 2,
    "name": "李四"
  }
]
  查ID=1: {
  "age": 25,
  "email": "z@ex.com",
  "id": 1,
  "name": "张三"
}

=== GORM风格SQL ===
  SELECT
  INSERT
  UPDATE

=== 连接池 ===
MaxOpen:100 MaxIdle:10 MaxLifetime:1h

🧠 GORM

GORM: Go最流行的ORM CRUD: Create/Find/First/Update/Delete 查询: Where/Select/Order/Limit 关联: HasMany/BelongsTo/Many2Many

连接池

db, _ := gorm.Open(postgres.Open(dsn))
db.DB().SetMaxOpenConns(100)
db.DB().SetMaxIdleConns(10)
db.DB().SetConnMaxLifetime(time.Hour)

🔑 本课要点回顾

知识点	关键内容
GORM	Create/Find/First/Update/Delete
模型	结构体+标签
查询	Where/Order/Limit
连接池	MaxOpen/MaxIdle

🏋️ 练习

关联查询

一对多/多对多

事务

Transaction

分页查询

Offset/Limit

🏆

成就解锁：数据层大师！

📖 延伸阅读

Go官方文档 — 深入理解本课主题
Effective Go — Go最佳实践
Go Blog — 官方博客设计决策解读
Go by Example — 实例学习

🎯 实战建议

动手编写代码，不要只看不练
使用go doc查看标准库文档
编写测试用例验证理解
阅读优秀开源项目的源码
在项目中应用所学知识

⚡ 性能提示

// 1. 预分配切片容量
s := make([]int, 0, expectedSize)

// 2. 使用strings.Builder拼接
var b strings.Builder
b.WriteString("hello")

// 3. 对象池复用
var bufPool = sync.Pool{New: func() interface{} { return new(bytes.Buffer) }}

// 4. 减少逃逸分析
// 小对象栈分配，大对象堆分配

// 5. benchmark测试
func BenchmarkXxx(b *testing.B) {
    for i := 0; i < b.N; i++ { ... }
}

🔍 调试技巧

// 1. fmt.Printf格式化
fmt.Printf("%+v
", struct)  // 带字段名
fmt.Printf("%#v
", value)   // Go语法

// 2. log包
log.Printf("debug: value=%v", val)

// 3. delve调试器
// dlv debug ./main.go

// 4. pprof性能分析
import _ "net/http/pprof"
go http.ListenAndServe(":6060", nil)

📖 延伸阅读与资源

Go官方文档 — go.dev/doc 最权威的参考
Effective Go — go.dev/doc/effective_go 最佳实践指南
Go Blog — go.dev/blog 设计决策深度解读
Go by Example — gobyexample.com 实例驱动学习
Go语言中文网 — 中文社区与教程

🎯 实战开发建议

动手编码 — 只看不练等于没学，每课代码必须自己敲一遍
使用go doc — go doc fmt.Printf 查看标准库文档
编写测试 — go test 验证你的理解是否正确
阅读源码 — 标准库是Go最佳实践的活教材
项目实战 — 在真实项目中应用所学

⚡ Go性能优化清单

// 1. 预分配切片容量 — 避免频繁扩容
s := make([]int, 0, expectedSize)

// 2. strings.Builder拼接 — 比fmt.Sprintf快3-5倍
var b strings.Builder
b.WriteString("hello")
b.WriteString(" world")
result := b.String()

// 3. sync.Pool对象复用 — 减少GC压力
var bufPool = sync.Pool{
    New: func() interface{} { return new(bytes.Buffer) },
}
buf := bufPool.Get().(*bytes.Buffer)
defer bufPool.Put(buf)

// 4. 减少堆分配 — 小对象栈分配，避免逃逸
// 用 go build -gcflags="-m" 分析逃逸

// 5. 使用benchmark验证性能
func BenchmarkXxx(b *testing.B) {
    for i := 0; i < b.N; i++ {
        // 被测代码
    }
}
// go test -bench=. -benchmem

🔍 调试与排查技巧

// 1. 格式化调试输出
fmt.Printf("%+v
", myStruct)  // 带字段名
fmt.Printf("%#v
", myValue)   // Go语法表示

// 2. log包运行时日志
log.Printf("[DEBUG] value=%v", val)
log.SetFlags(log.LstdFlags | log.Lshortfile)

// 3. delve源码调试器
// 安装: go install github.com/go-delve/delve/cmd/dlv@latest
// 使用: dlv debug ./main.go
// 命令: break main.main / continue / next / print

// 4. pprof性能分析
import _ "net/http/pprof"
go http.ListenAndServe(":6060", nil)
// 访问: http://localhost:6060/debug/pprof/
// 命令: go tool pprof http://localhost:6060/debug/pprof/profile

// 5. race detector竞态检测
// go run -race main.go
// go test -race ./...

📊 Go工具生态

工具	用途	安装
golangci-lint	代码静态检查	go install github.com/golangci/golangci-lint/cmd/...@latest
gofumpt	代码格式化(增强)	go install mvdan.cc/gofumpt@latest
goimports	自动管理import	go install golang.org/x/tools/cmd/goimports@latest
dlv	源码调试器	go install github.com/go-delve/delve/cmd/dlv@latest
air	热重载开发	go install github.com/cosmtrek/air@latest
swag	Swagger文档生成	go install github.com/swaggo/swag/cmd/swag@latest
migrate	数据库迁移	go install -tags 'postgres' github.com/golang-migrate/migrate/v4/cmd/migrate@latest

🏗️ Go项目结构最佳实践

myproject/
├── cmd/                    # 可执行程序入口
│   └── server/
│       └── main.go
├── internal/               # 私有代码(不可外部导入)
│   ├── handler/            # HTTP处理
│   ├── service/            # 业务逻辑
│   ├── repository/         # 数据访问
│   └── model/              # 数据模型
├── pkg/                    # 可复用公共包
│   └── utils/
├── api/                    # API定义(proto/openapi)
├── configs/                # 配置文件
├── scripts/                # 构建/部署脚本
├── test/                   # 集成测试
├── go.mod
├── go.sum
├── Makefile
└── Dockerfile

🌐 Go Web开发生态

类别	推荐方案	替代方案
Web框架	Gin	Echo / Chi / Fiber
ORM	GORM	Ent / sqlx / sqlc
配置	Viper	koanf
日志	zap	zerolog / slog
验证	validator	go-playground/validator
缓存	go-redis	redigo
JWT	golang-jwt	—
Swagger	swag	—
测试	testify	—
Mock	gomock	testify/mock

💡 编码规范

// 命名规范
// 包名: 小写单词, 不用下划线  package httputil
// 导出: 大写开头              func CreateUser()
// 未导出: 小写开头            func validateInput()
// 接口: -er后缀              type Reader interface{}
// 常量: 驼峰                 const maxRetries = 3
// 枚举: 类型+常量            type Role int; const Admin Role = 0

// 错误处理规范
// 错误变量: Err前缀           var ErrNotFound = errors.New("...")
// 错误类型: Error后缀         type ValidationError struct{...}
// 包装: %w                    fmt.Errorf("查询失败: %w", err)

// 注释规范
// 导出符号必须有注释
// 注释以符号名开头            // CreateUser creates a new user.
// 包注释: doc.go              // Package user handles user operations.

← 上一课 📖 课程目录下一课 →