用途
Go Ecosystem 是一个用于 Go 语言开发的技能,当用户要求“write go”“golang”“go.mod”“go module”“go test”“go build”,或进行 Go 语言相关开发工作时启用。它提供一套围绕 Go 语言惯例、标准库、并发模型和工程实践的指导内容。
主要能力
命名约定
- 包名使用小写、单词形式,不使用下划线或混合大小写,例如
package httputil。 - 导出(公开)标识符使用 PascalCase,例如
func ReadFile()、type Handler、var MaxRetries。 - 非导出(私有)标识符使用 camelCase,例如
func parseConfig()、type handler、var maxRetries。 - 单方法接口使用“方法名 + er”后缀,例如
Reader、Writer、Closer、Stringer、Handler。 - 缩写保持大写,例如
URL、HTTP、ID、API,如func ServeHTTP()、type HTTPClient、var userID。 - getter 不加“Get”前缀,例如
func (u *User) Name() string,而非GetName()。
类型系统
- 零值有意义:
0、""、nil、false。例如var buf bytes.Buffer可直接使用,无需初始化。 - 安全类型断言使用 ok 模式:
value, ok := x.(Type);不安全断言value := x.(Type)在类型错误时会 panic。 - 类型 switch 用于处理多种类型:
switch v := x.(type),可分别匹配string、int、default。
错误处理
- 错误是值,不是异常;应在每个调用点显式处理。
- 返回错误,不要 panic;传播错误时添加上下文。
- 自定义错误类型示例:
func (e *ValidationError) Error() string { return fmt.Sprintf("validation failed for %s: %s", e.Field, e.Message) }。 - 提取自定义错误类型:
var valErr *ValidationError; if errors.As(err, &valErr) { log.Printf("field: %s", valErr.Field) }。
现代 Go 特性
- Go 1.26 默认启用 Green Tea 垃圾回收器,提升 GC 性能。
- Go 1.26 内置
new函数允许指定初始值表达式:p := new(MyStruct{Field: "value"})。 - Go 1.26 泛型类型可在自身类型参数列表中引用自身。
- Go 1.22+ 支持对整数 range:
for i := range 10 { fmt.Println(i) }。 - Go 1.23+ 支持对迭代器函数 range:
for v := range slices.Values(s) { fmt.Println(v) }。 - Go 1.26 中 cgo 基线开销降低约 30%。
常见接口
Read(p []byte) (n int, err error)Write(p []byte) (n int, err error)Close() errorError() stringString() string
go.mod 示例
go 1.26
toolchain go1.26.0
require (
github.com/pkg/errors v0.9.1
golang.org/x/sync v0.3.0
)
require (
golang.org/x/sys v0.10.0 // indirect
)
项目结构
标准布局包括:主应用(cmd/myapp/main.go)、私有包(不可外部导入)、公共库代码(可选,有争议)、API 定义(OpenAPI、protobuf)、配置文件、构建/安装脚本、测试夹具。
最佳实践:
cmd/myapp/main.go应尽量精简,调用internal包。internal/包不能被父模块外部导入。- 每个目录一个包(
_test包除外)。
并发模式
- 使用
sync.WaitGroup等待多个 goroutine 完成:
var wg sync.WaitGroup
for _, item := range items {
wg.Add(1)
go func(item Item) {
defer wg.Done()
process(item)
}(item)
}
wg.Wait()
- 缓冲通道:
ch := make(chan int, 10)。 - 只接收通道参数:
func consumer(ch <-chan int)。 - 只发送通道参数:
func producer(ch chan<- int)。 - select 多路复用:
select {
case msg := <-ch1:
handle(msg)
case ch2 <- value:
// sent
case <-ctx.Done():
return ctx.Err()
default:
// non-blocking
}
- 关闭通道表示不再发送值:
close(ch),配合for v := range ch { }接收直到关闭。 - 结合 context 的 select:
select {
case result := <-doWork(ctx):
return result, nil
case <-ctx.Done():
return nil, ctx.Err()
}
sync 包
- 互斥锁
- 读写锁
- 仅执行一次
- 等待 goroutine 完成
- 并发 map(特定用例)
标准库新增
- 结构化日志
log/slog(Go 1.21+),新项目推荐优先于log和第三方日志库:
import "log/slog"
slog.Info("user logged in",
"user_id", userID,
"ip", request.RemoteAddr,
)
logger := slog.New(slog.NewJSONHandler(os.Stdout, nil))
logger.Info("request", "method", r.Method, "path", r.URL.Path)
- slices 包:
slices.Sort(names)、slices.Contains(names, "alice")、slices.Index(names, "bob")、keys := slices.Collect(maps.Keys(m))。 - cmp 包:默认值模式
name := cmp.Or(userInput, envVar, "default");有序比较result := cmp.Compare(a, b)。 - HTTP 路由路径值:
id := r.PathValue("id")。
构建命令
- 编译包:从当前包构建可执行文件。
- 指定输出名称:自定义二进制名称。
- 编译并安装到 GOPATH/bin:全局安装包。
- 编译并运行:快速编译执行,用于开发。
- 格式化所有代码:递归所有包,统一代码格式。
- 静态分析:递归所有包,检测可疑代码结构。
- 运行代码生成器:执行
//go:generate指令。 - golangci-lint:标准元 linter,聚合多个 linter,使用
golangci-lint run。 - 交叉编译:
GOOS=linux GOARCH=amd64 go build,为不同操作系统和架构构建二进制。
Context7 集成
使用 Context7 MCP 获取最新 Go 文档。使用模式:从 Context7 检索 Go 模块文档,例如 get-library-docs context7CompatibleLibraryID="/golang/website" topic="go.mod modules"。
使用方式
该技能在用户提出 Go 相关开发请求时自动启用,提供上述规范、模式与命令参考。开发者可依据其中的命名、错误处理、并发和项目结构指导编写代码,并通过 Context7 MCP 查询最新文档。
适用场景
- 编写 Go 代码、定义包与接口。
- 管理 go.mod 与模块依赖。
- 编写和运行 Go 测试、构建。
- 处理并发、错误与上下文取消。
- 遵循 Go 项目标准布局与最佳实践。
限制
- 资料未提供该技能的安装方式、收费信息、平台支持范围或具体效果数据。
- 部分内容(如 Go 1.26 特性)依赖对应 Go 版本,实际可用性以官方发布为准。
- 资料未提供相关技能与相关智能体的具体名称与调用方式。