Best Practices

Learn go best practices through an executable example, then connect the small demonstration to production code.

Idiomatic Go favors small clear functions, explicit errors, meaningful names, gofmt, tests and correct cancellation. Prefer simple abstractions until requirements justify more complexity.

This example applies input validation, error return values and deterministic output rather than hiding failures in global state.

Follow this diagram before executing the example. Check where a value or decision changes what runs next.

Daily checks: gofmt -w . (or go fmt ./...), go vet ./..., go test ./... and go test -race ./... where relevant.

This example is a complete program. Save it as main.go or paste it into the Go Playground.

Go code

package main

import (
	"fmt"
	"strings"
)

func greeting(name string) (string, error) {
	name = strings.TrimSpace(name)
	if name == "" {
		return "", fmt.Errorf("name is required")
	}
	return "Hello, " + name, nil
}
func main() {
	for _, name := range []string{"Go", " "} {
		message, err := greeting(name)
		if err != nil {
			fmt.Println("Error:", err)
			continue
		}
		fmt.Println(message)
	}
}

Output

Hello, Go
Error: name is required

The first input returns a successful greeting. The whitespace-only input returns an explicit error, which main handles without crashing.

• Do not ignore returned errors using _ unless the outcome is knowingly safe.
• Use interfaces where they enable clear contracts or testing, not just to imitate another language.

Add table-driven tests for empty input, whitespace and a valid name; run gofmt, go vet and go test.

Tip: Edit the example above, predict the output, and run the modified code to test your reasoning.

You have practiced Go Best Practices in a small, self-contained program. The important habit is to predict what runs, inspect the actual output and distinguish the language rule from the particular example.

Before continuing, make sure you can explain the program to someone who has not seen it, including the line that changes its result.