SuperAPI AI 工具集

Go Ecosystem

编程与开发

查看项目

更新于 10-16 05:58

技能介绍

用途

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() error
  • Error() string
  • String() 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 版本,实际可用性以官方发布为准。
  • 资料未提供相关技能与相关智能体的具体名称与调用方式。