必须用 go.etcd.io/bbolt 替代已归档的 github.com/boltdb/bolt，导入、依赖、安装均需更新；open 须显式指定 0600 权限；读写事务严格分离，key/bucket 必须为 []byte，小整数 key 需用 binary.bigendian 编码。
别用 github.com/boltdb/bolt —— 2026年它已彻底失效，必须用 go.etcd.io/bbolt
导入路径和模块依赖必须更新
旧项目迁移到 2026 年 Go 环境后，go mod tidy 会直接报错：module github.com/boltdb/bolt: not found。这不是缓存问题，是官方归档行为。
- 新项目唯一合法 import 是：
import "go.etcd.io/bbolt" - 安装命令必须是：
go get go.etcd.io/bbolt@latest - 如果代码里还留着
github.com/boltdb/bolt，编译器会拒绝加载，连类型检查都过不了
Open() 时权限掩码不能省，0600 是硬性要求
文件权限不是“建议”，而是 BoltDB 的安全前提。不设或设错（比如 0644），db.Open() 可能成功，但后续 Update() 会因 mmap 失败 panic，错误信息常为 invalid argument 或静默卡死。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 必须显式传入：
bbolt.Open("data.db", 0600, nil) - 0600 表示仅属主可读写，BoltDB 不处理权限降级，也不会自动 chmod
- 在 Docker 或 systemd 服务中运行时，确保进程 UID 对该路径有写权限，否则
timeout acquiring lock其实是权限被拒的伪装
事务模式选错会导致数据静默丢失或 panic
读写混用是最常见、最隐蔽的坑：在 db.View() 里调 b.Put() 不报错，但键值根本没存进去；反过来在 db.Update() 里只读不写，虽不 panic，但浪费写锁，拖慢并发。
- 只读查询一律用：
db.View(func(tx *bbolt.Tx) error { ... }) - 写操作（含建桶）一律用：
db.Update(func(tx *bbolt.Tx) error { ... }) - 批量写优先考虑
db.Batch()，它内部自动重试，比手写循环调Update()更可靠 - 所有事务闭包里，必须返回
nil才提交；返回任何 error 都触发回滚，且不会覆盖之前已执行的 Put/Get
Bucket 和 key 必须是 []byte，别信 string 能隐式转换
Go 类型系统不会帮你兜底。传 "users" 给 tx.Bucket() 直接编译失败；传 string([]byte("users")) 也不行——类型是 string，而函数签名明确要求 []byte。
- 桶名写法只有两种安全形式：
[]byte("users")或[]byte(bucketName) - key/value 同理，结构体要先
json.Marshal()成[]byte，不能直接传指针或 interface{} - 小整数当 key 时，别用
strconv.Itoa(123)，改用binary.BigEndian.PutUint64(buf, uint64(n))，否则范围查询（如b.ForEach()）顺序错乱 -
b.Get()返回nil表示 key 不存在，不是空 slice；判空用v == nil，别用len(v) == 0
真正麻烦的不是语法，而是那些“看起来跑通了”的错误：View 里写数据、权限设成 0644、用 string 当 bucket 名却靠 IDE 自动补全蒙混过关。这些在本地单测里几乎不暴露，一上生产就丢数据或锁死进程。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
