小蓝书 Go
零基础入门

06|读懂本项目需要的 Go 基础

前一站:业务体验 · 下一站:沿请求读代码

从最小程序开始#

在项目外新建练习文件夹,写一个 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 和一个结构体;用中文说明它们各解决什么问题。进阶阅读可在能读懂请求链路后再学泛型、调度和内存模型。

— 本篇阅读完毕 —
来源:小蓝书 Go / docs / 01-beginner/06-go-basics.md 下载原文
输入关键词,在三个知识库中搜索
支持正文检索 · 直接定位章节Esc 关闭