Golang 选库时如何挑选生产可用依赖并优先使用标准库

当需要为 Go 项目推荐、比较或新增第三方库/框架时，按类别评估成熟度并优先考虑标准库。

适用场景

解决思路

1. 先评估需求：理解具体用例、性能要求和约束条件。
2. 始终先检查标准库能否解决问题；仅当外部库带来明确价值时才推荐。
3. 推荐前必须核查维护状态、许可证和社区采用度：用 pkg.go.dev 上的 `imported-by` 数量作为流行度与间接质量信号——被广泛导入的库经过更多实战检验、有更强的向后兼容压力。
4. 考量复杂度：在 Go 中更简单的方案通常更好。
5. 考量依赖成本：依赖越多，攻击面越大、维护负担越重。
6. 按类别查阅参考目录：标准库新增与实验性包（v2 包、从 x/exp 提升的包、golang.org/x 扩展）、按类别整理的库（web、数据库、测试、日志、消息等）、开发工具（调试、lint、测试、依赖管理）。
7. 在 <https://github.com/avelino/awesome-go> 查找更多库。
8. 探索候选库时，使用 `godig` 查文档、符号、版本、importers 和已知漏洞，Go 包事实优先用它而不是 Context7。
9. 候选库加入构建后，使用 `gopls` 浏览其实际解析后的源码并并排比较候选库。
10. 对于 pkg.go.dev 未收录的文档，回退使用 Context7。
11. 避免反模式：不要用复杂库过度设计简单问题。
12. 避免反模式：不要用仅包装标准库功能却不增加价值的库。
13. 避免反模式：不要推荐已废弃或无人维护的库，如要推荐须先询问开发者。
14. 避免反模式：不要为简单需求建议依赖足迹庞大的库。
15. 避免反模式：不要忽略标准库替代方案。
16. 记住：最好的库往往是不用库；Go 标准库很优秀，足以覆盖许多用例。
17. 选定某个库之后的 API 细节，转看该库的专属技能（如 `samber/cc-skills-golang@golang-samber-lo`）。
18. `go.mod` 机制、升级与漏洞审计不在本技能范围，转看 `samber/cc-skills-golang@golang-dependency-management`。
19. 依赖注入细节转看 `samber/cc-skills-golang@golang-samber-do`，内存缓存转看 `samber/cc-skills-golang@golang-samber-hot`，错误处理转看 `samber/cc-skills-golang@golang-samber-oops`，测试转看 `samber/cc-skills-golang@golang-stretchr-testify`，gRPC 转看 `samber/cc-skills-golang@golang-grpc`。

适用边界 · 注意事项

• 已选定某个具体库、需要了解其 API 用法时——应看该库的专属技能。
• 处理 go.mod 机制、依赖升级或漏洞审计时——应看依赖管理技能。
• 不是 Go 项目或不需要做库选型时。