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

前一站：[业务体验](05-business-walkthrough.md) · 下一站：[沿请求读代码](07-read-code.md)

## 从最小程序开始

在项目外新建练习文件夹，写一个 `main.go`，不要覆盖项目入口：

```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。练习结束后回到项目根目录再执行项目命令。

## 结构体：把相关字段放在一起

```go
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](../../internal/domain/types.go)。看到 `[]string` 读成“字符串切片”，例如一篇笔记的多张图片地址；看到 `map[string]any` 读成“键是字符串，值可以不同类型的映射”。不熟悉 any 时可以先理解为任意类型。

## 函数和错误值

```go
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：离开时收尾

```go
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` 和一个结构体；用中文说明它们各解决什么问题。进阶阅读可在能读懂请求链路后再学泛型、调度和内存模型。
