How does sync.WaitGroup work and what are common mistakes?

var wg sync.WaitGroup

// CORRECT: Add BEFORE launching the goroutine
for i := 0; i < 5; i++ {
    wg.Add(1)                 // increment BEFORE go statement
    go func(id int) {
        defer wg.Done()       // always use defer — ensures Done even on panic
        fmt.Println("worker", id)
    }(i)
}
wg.Wait() // blocks until count reaches zero

// WRONG: Add inside the goroutine — race condition
for i := 0; i < 5; i++ {
    go func(id int) {
        wg.Add(1)   // may execute AFTER Wait() returns — data race!
        defer wg.Done()
        fmt.Println(id)
    }(i)
}
wg.Wait() // might return before all goroutines call Add

// WRONG: reusing WaitGroup before Wait returns
// Do not call Add on a WaitGroup whose Wait has not yet returned

// Pattern: limit concurrency with a semaphore channel
sem := make(chan struct{}, 10) // max 10 goroutines at once
for _, item := range items {
    wg.Add(1)
    sem <- struct{}{} // acquire slot
    go func(it Item) {
        defer func() { <-sem; wg.Done() }()
        process(it)
    }(item)
}
wg.Wait()