在 Go 中选择或优化数据结构时：切片/映射内部机制…

当你需要为 Go 项目挑选合适的数据结构、理解 slice/map 内部行为、实现泛型容器或使用 unsafe/weak 指针时使用。

适用场景

解决思路

1. 当大小已知或可估算时，用 `make(T, 0, n)` / `make(map[K]V, n)` 预分配切片和映射，避免反复扩容拷贝和 rehash
2. 仅在大小在编译期固定时（如哈希摘要、IPv4 地址、矩阵维度）才优先用数组而非切片
3. 绝不要依赖切片容量增长的时机——增长算法在 Go 版本间已变化，代码不应依赖新底层数组何时分配
4. 优先用 `container/heap` 实现优先队列，仅在需要频繁中间插入时用 `container/list`，用 `container/ring` 实现固定大小环形缓冲
5. 构建字符串必须优先用 `strings.Builder`；需要双向 I/O（同时实现 `io.Reader` 和 `io.Writer`）时必须优先用 `bytes.Buffer`
6. 泛型数据结构应使用尽可能紧的约束——键用 `comparable`，排序用 `cmp.Ordered`，领域排序用自定义接口
7. `unsafe.Pointer` 必须只遵循 Go 规范的 6 种合法转换模式——绝不要跨语句存入 `uintptr` 变量
8. `weak.Pointer[T]`（Go 1.24+）应用于缓存和规范化映射，让 GC 能回收条目
9. 切片扩容规律：元素 < 256 时容量翻倍；>= 256 时按约 25% 增长（`newcap += (newcap + 3*256) / 4`）；每次扩容都拷贝整个底层数组，复杂度 O(n)
10. 预分配示例：大小精确时用 `make([]User, 0, len(ids))`；大小近似时用 `make([]Result, 0, estimatedCount)`；批量 append 前用 `slices.Grow(s, additionalNeeded)`（Go 1.21+）
11. 使用 `slices` 包（Go 1.21+）的 `Sort`/`SortFunc`、`BinarySearch`、`Contains`、`Compact`、`Grow`；`Clone`、`Equal`、`DeleteFunc` 见安全技能
12. 映射预分配用 `make(map[string]*User, len(users))` 以避免填充期间 rehash
13. 使用 `maps` 包（Go 1.21+）：`Collect`（1.23+）从迭代器构建映射，`Insert`（1.23+）从迭代器插入条目，`All`（1.23+）遍历所有条目，`Keys`/`Values` 遍历键/值
14. 数组是值类型，赋值时整体拷贝；可用于编译期已知大小场景，如 `type Digest [32]byte`、`var grid [3][3]int`、`map[[2]int]Result{}`（数组可比较，可作映射键）；其他情况优先用切片
15. container 类型使用 `any`（无类型安全），考虑用泛型包装器增强类型安全
16. 用 `strings.Builder` 做纯字符串拼接（`String()` 时避免拷贝），需要 `io.Reader` 或字节操作时用 `bytes.Buffer`；两者都支持 `Grow(n)`
17. 泛型集合示例：`type Set[T comparable] map[T]struct{}`，并实现 `Add`、`Contains` 等方法
18. 指针类型选择：`*T` 用于常规间接、可变、可选值（零值 `nil`）；`unsafe.Pointer` 用于 FFI 和底层内存布局（仅 6 种规范模式）；`weak.Pointer[T]`（1.24+）用于缓存、规范化、弱引用
19. 拷贝语义速查：`int`/`float`/`bool`/`string` 值拷贝完全独立；`array`/`struct` 值拷贝完全独立；`slice` 拷贝头部但共享底层数组（用 `slices.Clone`）；`map` 拷贝引用（用 `maps.Clone`）；`channel` 拷贝引用指向同一 channel；`*T` 拷贝地址指向同一值；`interface` 拷贝类型+值对，独立性取决于所持类型
20. 需要标准库之外的高级数据结构（树、集合、队列、栈）时考虑第三方库：`emirpasic/gods`（全面集合库）、`deckarep/golang-set`（线程安全与非线程安全集合）、`gammazero/deque`（快速双端队列）；使用时参考其官方文档和示例获取最新 API
21. 查询 Go 包文档、符号、版本、导入者和已知漏洞时优先用 `godig`（pkg.go.dev）而非 Context7；用 `gopls` 导航库在代码中的使用（定义、调用点、诊断）；Context7 作为 pkg.go.dev 未索引文档的兜底
22. 避免常见错误：循环中不预分配地增长切片（每次扩容 O(n) 拷贝整个底层数组，改用 `make([]T, 0, n)` 或 `slices.Grow`）；切片够用时用 `container/list`（链表缓存局部性差，每个节点单独堆分配，先基准测试）；纯字符串拼接用 `bytes.Buffer`（其 `String()` 会拷贝底层字节，`strings.Builder` 避免此拷贝）；跨语句把 `unsafe.Pointer` 存为 `uintptr`（GC 可能在语句间移动对象，`uintptr` 变成悬垂引用）；映射中存大结构体值（访问会拷贝整个值，大值类型用 `map[K]*V` 避免拷贝）

适用边界 · 注意事项

• 当性能分析已定位瓶颈、需要应用优化模式时（改用 `samber/cc-skills-golang@golang-performance` 技能）
• 涉及 nil map/slice 陷阱、append 别名、防御性拷贝等安全问题时（改用 `samber/cc-skills-golang@golang-safety` 技能）
• 涉及 channel、`sync.Map`、`sync.Pool` 及同步原语时（改用 `samber/cc-skills-golang@golang-concurrency` 技能）