Data Race Detector

Official guide to race detector behavior, usage, reports, and practical limitations.

• Author: Go Team
• Authority: primary
• Kind: article
• URL: https://go.dev/doc/articles/race_detector.html

What it covers

• running the race detector
• interpreting reports
• limitations of dynamic race detection

Why authoritative

Official documentation for the Go race detector tool.

Use when

• how do I use the Go race detector
• what does this race detector report mean
• will the race detector catch this bug

Keywords

• race detector, data race, concurrency, testing, debugging

Used by

• race-detector
• memory-model