从最小程序开始#
在项目外新建练习文件夹,写一个 main.go,不要覆盖项目入口:
package main import "fmt" func main() { title := "我的第一篇笔记" fmt.Println(title) } |
package main 表示这是可执行程序的包;import 引入别人提供的功能;func 定义函数;main 是程序入口;:= 让 Go 根据右侧推断变量类型。双引号表示字符串。进入练习目录执行 go run main.go,应输出标题。
不要把这段直接追加到现有 cmd/server/main.go,同一个包里不能重复定义 main。练习结束后回到项目根目录再执行项目命令。
结构体:把相关字段放在一起#
type NoteInput struct { ID int64 `json:"id"` Title string `json:"title"` Content string `json:"content"` } |
type 定义类型;struct 把相关字段组合;int64 是整数,string 是文本。反引号里的 tag 告诉 JSON 编解码器字段在接口里叫什么。Go 字段 Title 与 JSON 字段 title 因此可以对应。大写开头的字段能被其他包和编码器访问。
实际定义在 types.go ↗。看到 []string 读成“字符串切片”,例如一篇笔记的多张图片地址;看到 map[string]any 读成“键是字符串,值可以不同类型的映射”。不熟悉 any 时可以先理解为任意类型。
函数和错误值#
func require(a domain.Actor) error { if a.ID == 0 { return domain.Fail(401, "请先登录") } return nil } |
括号中是输入,括号后是输出。这里输出 error:nil 表示没有错误,非 nil 表示失败。Go 通常不靠异常跳转,而是逐层返回错误。if err != nil { return err } 表示当前操作失败就把错误交给上层,不假装成功。
func (...) (Note, error) 返回两个结果:业务数据和错误。调用时先检查 error,再使用数据。数据库返回错误时不能继续用零值 ID 发布成功提示。
指针和方法#
*Service 读作“指向 Service 的指针”,表示引用同一个服务对象,不是每次复制整个对象。func (s *Service) Login(...) 是附着在 Service 上的方法,通过 s.DB 使用同一数据库连接池。&value 表示取某个值的地址;Scan(&id) 需要地址,是为了把数据库结果写回 id 变量。
暂时不需要手工管理内存。Go 的垃圾回收处理不再使用的内存,但数据库 rows、文件和网络响应仍要主动 Close,不能全部交给垃圾回收。
defer:离开时收尾#
tx, err := db.BeginTx(ctx, nil) if err != nil { return err } defer tx.Rollback() // 执行业务 SQL return tx.Commit() |
defer 在当前函数返回前执行。提前失败时 Rollback 释放事务;Commit 成功后延迟 Rollback 不会撤销已提交数据。这里不是“先提交再回滚一次”,而是保证所有返回路径都有清理。
context、接口和并发先怎么读#
context.Context 传递取消信号和超时,HTTP 请求结束时数据库查询也可以停止等待。接口描述需要的方法而非固定实现,例如扫描器只要求 Scan,使同一个函数能读取单行和列表行。goroutine 以 go 开头并发执行;当前业务没有把每次 SQL 都随意放进 goroutine,关机监听才需要独立等待信号。
项目代码使用 gofmt 统一格式。修改后运行 gofmt -w 文件.go,再执行测试。格式改变不会自动修好业务逻辑。
验收:在 auth.go 里找出一次 return ..., err、一次 defer 和一个结构体;用中文说明它们各解决什么问题。进阶阅读可在能读懂请求链路后再学泛型、调度和内存模型。