sync.WaitGroup
Attendere un insieme di goroutine
sync.WaitGroup è una lezione Go Academy gratuita su CoddyKit. Questa è la lezione 2 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Go Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Go Academy include 4 lezioni in totale.
Scopo
sync.WaitGroup attende il completamento di un insieme di goroutine. La goroutine principale chiama Add per impostare il contatore, ogni goroutine chiama Done al termine e Wait si blocca finché il contatore non raggiunge zero.
Utilizzo di base
Esegua Add prima di avviare ogni goroutine, Done al termine di ogni goroutine (tramite defer) e Wait dopo aver avviato tutte le goroutine.
var wg sync.WaitGroup
for _, item := range items {
wg.Add(1)
go func(v Item) {
defer wg.Done()
process(v)
}(item)
}
wg.Wait()Add deve essere eseguito prima dell'avvio della goroutine
Chiami wg.Add(1) prima di go func(), mai all'interno della goroutine. Altrimenti Wait potrebbe restituire il controllo prima che la goroutine si registri.
Errore comune: cattura della variabile del ciclo
Passi la variabile del ciclo come argomento alla funzione della goroutine, anziché tramite una closure, per evitare che tutte le goroutine condividano la stessa variabile.
for _, v := range items {
wg.Add(1)
go func(item Item) { // correct: copy
defer wg.Done()
process(item)
}(v)
}Riutilizzare un WaitGroup
È possibile riutilizzare un WaitGroup dopo il ritorno di Wait, ma solo se tutte le chiamate Done precedenti sono terminate. Non lo riutilizzi mentre ci sono chiamate Done ancora in corso.
WaitGroup con risultati
WaitGroup non raccoglie i risultati: lo combini con un canale o con uno slice (protetto da un mutex) per raccogliere l'output delle goroutine.
results := make([]Result, len(items))
for i, item := range items {
wg.Add(1)
go func(idx int, v Item) {
defer wg.Done()
results[idx] = process(v)
}(i, item)
}
wg.Wait()Add con il conteggio del batch
È possibile passare il conteggio totale a un'unica chiamata ad Add prima del ciclo; è leggermente più efficiente rispetto a una chiamata ad Add per ogni goroutine.
wg.Add(len(items))
for _, item := range items {
go func(v Item) { defer wg.Done(); process(v) }(item)
}Non copi un WaitGroup
Come Mutex, un WaitGroup non deve essere copiato dopo il primo utilizzo. Lo passi tramite puntatore oppure lo incorpori in una struct passata tramite puntatore.
WaitGroup rispetto a errgroup
golang.org/x/sync/errgroup racchiude WaitGroup e aggiunge la propagazione degli errori. Preferisca errgroup quando il fallimento di una goroutine deve arrestare le altre.
Combinare con context
Utilizzi errgroup.WithContext per ottenere sia la semantica di WaitGroup sia un context che viene cancellato al primo errore, arrestando in modo ordinato tutte le goroutine.
g, ctx := errgroup.WithContext(context.Background())
g.Go(func() error { return doWork(ctx) })
if err := g.Wait(); err != nil { log.Fatal(err) }Il valore zero è utilizzabile
Il valore zero di sync.WaitGroup è pronto all'uso: non è necessario alcun costruttore. Lo dichiari e chiami Add.
Verifica rapida
Cosa accade se chiama wg.Add(1) all'interno della goroutine invece che prima di avviarla?
Riepilogo: sync.WaitGroup
Punti chiave:
- Add prima dell'avvio della goroutine; Done tramite defer all'interno della goroutine
- Wait si blocca finché il contatore non raggiunge zero
- Non copi mai il valore; non chiamare mai Add all'interno della goroutine
- Utilizzi errgroup per la propagazione degli errori
Domande Frequenti
La lezione «sync.WaitGroup» è gratuita?
Sì — il testo completo di «sync.WaitGroup» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Go Academy, passa a CoddyKit PRO. Il corso Go Academy include 4 lezioni in totale.
Cosa imparerò in «sync.WaitGroup»?
Attendere un insieme di goroutine Eserciti Go Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare Go Academy?
Non è richiesta alcuna esperienza precedente. Go Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 2 di 4.
Quanto tempo richiede la lezione «sync.WaitGroup»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione Go Academy?
Sì. Ogni lezione Go Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.