When to Use context.Background vs context.TODO in Go

Go context: Background vs TODO

context.Background()

Creates an empty Context with no values, deadline, or cancellation signal. It is the root of a context tree and is intended to be used as the top‑level context for a program, a server, or a long‑running operation when no other context is available.

Typical usage:

ctx := context.Background()
// pass ctx to functions that require a Context

context.TODO()

Also returns an empty Context identical to the one from Background, but its semantic purpose is to signal that the appropriate context has not yet been decided. It is a temporary placeholder during development, reminding developers to replace it with a more specific context (e.g., one with cancellation or a deadline) later.

ctx := context.TODO() // TODO: replace with request‑scoped context

Key differences

context.Background()

is the canonical root context; it should remain in production code when a true root is needed. context.TODO() should be removed or replaced before code is shipped, as it indicates incomplete context handling.