附录 B.标准库常用 API 速查

附录 A 管的是「语法怎么写」，这一页管的是「某个活儿该找哪个包」。它按「想做什么 → 用哪个包哪个函数」组织，覆盖全书真正用到、以及日常最常翻的标准库 API。

表里的函数签名都在本机 go1.27.0 上用 go doc 核对过，不是凭记忆写的；省略号表示签名里与查询无关的部分。带版本标注的 API 低于该版本不可用。

字符串处理：strings

strings 的函数都返回新串（string 不可变）。在循环里拼接大量字符串时，用 strings.Builder 而不是 +。

类型转换：strconv

Go 不会隐式转换数字与字符串，"1" + 1 直接编译失败；解析用 strconv，类型转换用 T(v)。

字节缓冲：bytes

bytes.Buffer 与 strings.Builder 类似，但它面向 []byte，同时可读可写，常用来拼装 HTTP 请求体。

时间：time

package main

import (
	"fmt"
	"time"
)

func main() {
	t := time.Date(2026, 10, 9, 10, 0, 0, 0, time.UTC)
	fmt.Println(t.Format(time.RFC3339))
	d, _ := time.ParseDuration("1h30m")
	fmt.Println(d.Minutes())
}

2026-10-09T10:00:00Z
90

布局字符串用的是「参考时间」2006-01-02 15:04:05，常量 time.RFC3339 最常用。判断时间是否为零值用 t.IsZero()。

JSON：encoding/json

结构体字段通过标签控制键名：ID int64 `json:"id"` ；omitempty 让零值字段被省略。json.Number 可避免大整数被转成 float64 丢精度。

文件与进程：os

os.ReadFile / os.WriteFile 是最常用的文件读写入口；写文件权限常写 0o644，目录常写 0o755。

输入输出：io

package main

import (
	"io"
	"os"
	"strings"
)

func main() {
	io.Copy(os.Stdout, strings.NewReader("hello\n"))
}

hello

读循环里判断结束，用 errors.Is(err, io.EOF) 而不是字符串比较。

格式化：fmt

常用动词：%v 默认、%+v 带字段名、%#v Go 语法、%T 类型、%q 加引号字符串、%d 整数、%s 字符串、%w 包装错误、%x 十六进制。

错误：errors

errors.Is 沿错误链逐层比较，errors.As 逐层做类型匹配；两者都不要求你手动 Unwrap。

泛型容器：slices / maps / cmp

package main

import (
	"cmp"
	"fmt"
	"maps"
	"slices"
)

func main() {
	xs := []int{3, 1, 2}
	slices.Sort(xs)
	slices.SortFunc(xs, func(a, b int) int { return cmp.Compare(b, a) })
	m := map[string]int{"b": 2, "a": 1}
	fmt.Println(xs, slices.Sorted(maps.Keys(m)))
	fmt.Println(cmp.Or("", "fallback"))
}

[3 2 1] [a b]
fallback

slices / maps 是 1.21 起提供的泛型标准库，优先于手写循环与 sort.Slice。maps.Keys / slices.Sorted 是 1.23 起的迭代器风格 API。

同步：sync / sync/atomic

Mutex 保护一段临界区，atomic 适合单个计数器的自增，sync.Map 只在读多写少、键集合稳定的场景才优于「Mutex + 普通 map」。

上下文：context

context 是函数第一个参数、命名约定为 ctx，不要把它塞进结构体。cancel 函数一定要 defer 调用，否则会泄漏。

HTTP 服务端：net/http

路由模式里的 {id} 是 1.22 起的增强，r.PathValue("id") 取出对应段；方法前缀（GET ）也由这套机制解析。

结构化日志：log/slog

package main

import (
	"log/slog"
	"os"
)

func main() {
	logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))
	logger.With("service", "taskapi").Info("started", "port", 8080)
}

{"time":"...","level":"INFO","msg":"started","service":"taskapi","port":8080}

slog 是 1.21 起的结构化日志标准库，输出是可被日志系统解析的键值对，优于 fmt.Println 式打印。

排序与数学：sort / math

新代码优先用泛型的 slices.Sort / slices.SortFunc（类型安全），sort.Slice 保留给需要自定义比较、又不便引入泛型的旧代码。

小结

• 字符串用 strings，拼接多时用 strings.Builder；数字与字符串互转用 strconv。
• 时间用 time，布局字符串是参考时间 2006-01-02 15:04:05，超时用 Duration。
• JSON 用 encoding/json，字段标签控制键名；流式处理用 Encoder / Decoder。
• 文件用 os.ReadFile / WriteFile，通用 I/O 用 io.Copy / ReadAll，结束判断用 errors.Is(err, io.EOF)。
• 错误用 errors.New 创建、fmt.Errorf + %w 包装、errors.Is / As 判定。
• 泛型容器优先用 slices / maps / cmp，它们比手写循环更安全也更简洁。
• 并发安全用 sync 与 sync/atomic；跨调用传递取消与超时用 context。
• 服务端用 net/http（1.22+ 路由模式），日志用 log/slog 输出结构化字段。

标准库足够大，不可能在这里穷尽。真正该记住的不是每个函数的名字，而是「这类需求大概归哪个包管」——想清楚这一点，去 go doc 里翻具体签名就是几分钟的事。附录 C 会继续整理 go 命令与工具链。