Go 语言惯用法实战指南

解决什么问题

很多开发者从 Java 或 Python 迁移到 Go 时，写出来的代码总带着一股“翻译腔”：过度设计接口、用异常捕获的思维处理错误、或者在使用 goroutine 时遭遇泄漏、死锁和数据竞争。这个技能专门针对这些“非 Go 味”的代码，帮你摆脱语言习惯的包袱，写出符合 Go 社区审美和工程规范的代码。

技能如何工作

该技能通过结构化的工作流，对代码和架构进行深度审查与重构建议：

• 代码审查与反模式修正：识别诸如滥用 interface{}（Go 1.18+ 应使用 any）、到处加锁（应优先用 channel 通信）、过度抽象等反模式，并提供改写对照。
• 错误处理与并发控制：规范 Go 1.13+ 的错误处理，包括哨兵错误和自定义错误类型；提供 errgroup、worker pool 和 pipeline 等并发模式的完整示例，并强调 context 在 goroutine 生命周期管理中的作用。
• 接口设计与项目结构：遵循“接受接口，返回结构体”原则，指导接口在消费方定义。同时给出包拆分和命名（如使用单数名词）的工程建议。

适用边界与注意点

本技能聚焦于 Go 语言的核心惯用法和底层设计模式。它不适用于 Go 语法入门教学（建议先阅读 Tour of Go），也不会深入探讨特定 Web 框架（如 Gin、Echo 或 Fiber）的框架级最佳实践。它更适合作为你日常 Go 开发的“代码审查员”和架构顾问。