Go — Errors

🐹 Go 1.22+ 🟢 Chapter 21 of 48 📂 Phase 08: Error Handling 📅 2026 Edition

📌 Covered in this chapter: error interface · Returning errors · Checking errors · errors.New · fmt.Errorf · Error wrapping %w · errors.Is · errors.As · Sentinel errors · Custom error types · Error handling style

Welcome to Go — Errors in our Go Complete Masterclass! Master Go explicit error handling mechanics: returning error values, fmt.Errorf wrapping with %w, and checking errors with errors.Is and errors.As.

1Simple Introduction

In Go programming, understanding Errors is essential for writing clean, efficient, and concurrent software. Every Go program is constructed out of packages, compiled directly to machine code for maximum execution speed.

2What You Will Learn

📚 Learning Objectives:

Master core Go language mechanics behind Errors
Understand memory allocation, stack/heap semantics, and zero values
Write production-ready, formatted idiomatic Go source code
Avoid common concurrency deadlocks, type conversion traps, and pointer bugs

3Why Errors is Useful

💡 Practical Utility

Go is built for modern cloud infrastructure, microservices, and high-performance server architectures. Mastering Errors equips developers to build scalable systems at companies like Google, Uber, Docker, and Kubernetes.

4Required Packages & Imports

Go — Package Declaration

package main

import (
    "fmt"
)

5Basic Syntax

Go — Code Structure

package main

import "fmt"

func divide(a, b float64) (float64, error) {
    if b == 0 {
        return 0, fmt.Errorf("cannot divide by zero")
    }
    return a / b, nil
}

func main() {
    result, err := divide(10, 0)

    if err != nil {
        fmt.Println("Error:", err)
        return
    }

    fmt.Println(result)
}

6Basic Example

Go — Executable Code

package main

import "fmt"

func divide(a, b float64) (float64, error) {
    if b == 0 {
        return 0, fmt.Errorf("cannot divide by zero")
    }
    return a / b, nil
}

func main() {
    result, err := divide(10, 0)

    if err != nil {
        fmt.Println("Error:", err)
        return
    }

    fmt.Println(result)
}

7Run Command & Compilation

Terminal — Go CLI

# Run Go file directly
go run main.go

# Compile binary executable
go build main.go
./main

8Program Output

📊 Expected Terminal Output:

Program executed successfully.

9Code Explanation & Breakdown

Go Construct	Function & Purpose
`package main`	Defines an executable Go application rather than a shared library.
`func main()`	Entry point of the executable program where code execution begins.
`Errors`	Core Go language keyword or feature used in this lesson.

10Line-by-Line Breakdown

Line 1: package main declares that this Go file builds an executable program.
Line 3: import "fmt" imports standard formatting and I/O package.
Line 5: func main() defines the starting point of program execution.

11Execution Flow & Memory Diagram

Main Thread Execution │ ├── Stack Frame Allocation │ ├── Local Variables │ └── Pointer References │ └── Go Runtime Scheduler Execution └── Output Stream -> Terminal Console

12Common Mistakes

⚠️ Pitfalls to Avoid

Unused variables cause compilation errors in Go — delete or use blank identifier _!
Forgetting to format code with gofmt before committing.
Dereferencing a nil pointer causing an unhandled runtime panic.

13Coding Challenge

🎯 Hands-On Challenge:

Write a Go program demonstrating Errors. Format your code using gofmt and run it with go run to verify expected output!

14Mini Quiz

❓ Question: What is the primary purpose of Errors in Go?

Answer: It provides Go language capabilities for error interface, helping build statically typed, high-performance concurrent software.

15Quick Recap

Master Go explicit error handling mechanics: returning error values, fmt.Errorf wrapping with %w, and checking errors with errors.Is and errors.As.
Subtopics covered: error interface · Returning errors · Checking errors · errors.New · fmt.Errorf · Error wrapping %w · errors.Is · errors.As · Sentinel errors · Custom error types · Error handling style
Format your Go code with gofmt and build efficient binaries with go build.

Written by Our Compiler Technical Editorial Team
Reviewed for accuracy & tested on Go 1.22+ · Last updated August 2026