AgentSkillsCN

go-error-wrapping

使用 fmt.Errorf %w 模式包装错误并附上下文

SKILL.md
--- frontmatter
name: go-error-wrapping
description: Wrap errors with context using fmt.Errorf %w pattern

Error Wrapping with %w

Pattern

Use fmt.Errorf with %w to add context while preserving the error chain.

CORRECT

go
func ReadConfig(path string) (*Config, error) {
    data, err := os.ReadFile(path)
    if err != nil {
        return nil, fmt.Errorf("read config %s: %w", path, err)
    }

    var cfg Config
    if err := json.Unmarshal(data, &cfg); err != nil {
        return nil, fmt.Errorf("parse config %s: %w", path, err)
    }

    return &cfg, nil
}

WRONG

go
// Bad: Loses error chain
return nil, fmt.Errorf("read config failed: %v", err)

// Bad: No context
return nil, err

// Bad: String concatenation
return nil, errors.New("read config: " + err.Error())

Key Rules

  1. •Use %w to wrap, not %v or %s
  2. •Add meaningful context (file names, IDs, operations)
  3. •Keep messages lowercase, no punctuation
  4. •Preserve original error for type checking

Example Chain

go
// Error flows up with context at each layer:
// "process user 123: read config /etc/app.conf: open /etc/app.conf: no such file or directory"

func ProcessUser(id int) error {
    cfg, err := ReadConfig("/etc/app.conf")
    if err != nil {
        return fmt.Errorf("process user %d: %w", id, err)
    }
    // use cfg...
    return nil
}