How to implement a thread-safe counter in Go?
To implement a thread-safe counter in Go, use either mutexes or atomic operations. 1. Mutexes ensure safe access by locking shared data, allowing only one goroutine to modify the counter at a time, as demonstrated with the sync.Mutex in a Counter struct. 2. Atomic operations such as atomic.AddInt32 provide a lock-free and more efficient alternative for simple numeric counters. Use mutexes when protecting complex structures or multiple variables together, and prefer atomics for single-variable increments where performance is critical. Both approaches prevent race conditions and ensure thread safety in concurrent environments.
Implementing a thread-safe counter in Go is straightforward thanks to the language’s built-in concurrency tools. The key is to ensure that multiple goroutines can read and update the counter without causing race conditions. There are two main ways to do this: using mutexes or leveraging the atomic
package.

Using Mutex for Thread-Safe Counter
A common and clear way to protect shared data like a counter is by using a mutex from the sync
package. This ensures only one goroutine can modify the counter at a time.
Here's how you can do it:

package main import ( "fmt" "sync" ) type Counter struct { mu sync.Mutex value int } func (c *Counter) Inc() { c.mu.Lock() defer c.mu.Unlock() c.value } func (c *Counter) Value() int { c.mu.Lock() defer c.mu.Unlock() return c.value } func main() { var wg sync.WaitGroup counter := Counter{} for i := 0; i < 1000; i { wg.Add(1) go func() { defer wg.Done() counter.Inc() }() } wg.Wait() fmt.Println("Final counter value:", counter.Value()) }
- The
Inc()
method locks the mutex before incrementing the counter and unlocks after. - The
Value()
method also uses the mutex to safely return the current count. - This pattern avoids data races but may have some performance overhead due to locking.
Using Atomic Operations
If your use case is simple—like just incrementing a number—you can use the atomic
package, which provides low-level atomic operations that are faster than mutexes.
Here’s an example:

package main import ( "fmt" "runtime" "sync" "sync/atomic" ) func main() { var counter int32 var wg sync.WaitGroup for i := 0; i < 1000; i { wg.Add(1) go func() { defer wg.Done() atomic.AddInt32(&counter, 1) }() } wg.Wait() runtime.Gosched() // Optional, to give other goroutines a chance to finish fmt.Println("Final counter value:", counter) }
-
atomic.AddInt32
atomically increments the counter. - No need for explicit locks, which makes this method more efficient for simple counters.
- Make sure to use the correct type like
int32
orint64
, depending on your needs.
When to Use Mutex vs Atomic
-
Use a mutex when:
- You have more complex data structures or logic.
- You need to protect multiple variables or perform multiple operations as a group.
-
Use atomic when:
- You’re dealing with a single numeric variable.
- You want better performance and don’t need complex synchronization.
Both approaches work well in Go, so choose based on your specific situation.
That’s basically all you need to know. Whether you pick a mutex or atomic operation depends on simplicity and context — both will keep your counter safe in concurrent environments.
The above is the detailed content of How to implement a thread-safe counter in Go?. For more information, please follow other related articles on the PHP Chinese website!

Hot AI Tools

Undress AI Tool
Undress images for free

Undresser.AI Undress
AI-powered app for creating realistic nude photos

AI Clothes Remover
Online AI tool for removing clothes from photos.

Clothoff.io
AI clothes remover

Video Face Swap
Swap faces in any video effortlessly with our completely free AI face swap tool!

Hot Article

Hot Tools

Notepad++7.3.1
Easy-to-use and free code editor

SublimeText3 Chinese version
Chinese version, very easy to use

Zend Studio 13.0.1
Powerful PHP integrated development environment

Dreamweaver CS6
Visual web development tools

SublimeText3 Mac version
God-level code editing software (SublimeText3)

Hot Topics











TointegrateGolangserviceswithexistingPythoninfrastructure,useRESTAPIsorgRPCforinter-servicecommunication,allowingGoandPythonappstointeractseamlesslythroughstandardizedprotocols.1.UseRESTAPIs(viaframeworkslikeGininGoandFlaskinPython)orgRPC(withProtoco

Golangofferssuperiorperformance,nativeconcurrencyviagoroutines,andefficientresourceusage,makingitidealforhigh-traffic,low-latencyAPIs;2.Python,whileslowerduetointerpretationandtheGIL,provideseasierdevelopment,arichecosystem,andisbettersuitedforI/O-bo

Golang is mainly used for back-end development, but it can also play an indirect role in the front-end field. Its design goals focus on high-performance, concurrent processing and system-level programming, and are suitable for building back-end applications such as API servers, microservices, distributed systems, database operations and CLI tools. Although Golang is not the mainstream language for web front-end, it can be compiled into JavaScript through GopherJS, run on WebAssembly through TinyGo, or generate HTML pages with a template engine to participate in front-end development. However, modern front-end development still needs to rely on JavaScript/TypeScript and its ecosystem. Therefore, Golang is more suitable for the technology stack selection with high-performance backend as the core.

TocompletelyuninstallGolang,firstdeterminehowitwasinstalled(packagemanager,binary,source,etc.),thenremoveGobinariesanddirectories,cleanupenvironmentvariables,anddeleterelatedtoolsandcaches.Beginbycheckinginstallationmethod:commonmethodsincludepackage

In Go, if you want the structure field to use a custom field name when converting to JSON, you can implement it through the json tag of the structure field. 1. Use the json: "custom_name" tag to specify the key name of the field in JSON. For example, Namestringjson: "username"" will make the Name field output as "username"; 2. Add, omitempty can control that the output is omitted when the field is empty, such as Emailstringjson: "email,omitempty""

The key to installing Go is to select the correct version, configure environment variables, and verify the installation. 1. Go to the official website to download the installation package of the corresponding system. Windows uses .msi files, macOS uses .pkg files, Linux uses .tar.gz files and unzip them to /usr/local directory; 2. Configure environment variables, edit ~/.bashrc or ~/.zshrc in Linux/macOS to add PATH and GOPATH, and Windows set PATH to Go in the system properties; 3. Use the government command to verify the installation, and run the test program hello.go to confirm that the compilation and execution are normal. PATH settings and loops throughout the process

"Go:commandnotfound" is usually caused by incorrect configuration of environment variables; 1. Check whether Go has been installed correctly and use whichgo to confirm the path; 2. Manually add Go's bin directory (such as /usr/local/go/bin) to the PATH environment variable; 3. Modify the corresponding shell's configuration file (such as .bashrc or .zshrc) and execute source to make the configuration take effect; 4. Optionally set GOROOT and GOPATH to avoid subsequent module problems. After completing the above steps, run government and verify whether it is repaired.

Golang usually consumes less CPU and memory than Python when building web services. 1. Golang's goroutine model is efficient in scheduling, has strong concurrent request processing capabilities, and has lower CPU usage; 2. Go is compiled into native code, does not rely on virtual machines during runtime, and has smaller memory usage; 3. Python has greater CPU and memory overhead in concurrent scenarios due to GIL and interpretation execution mechanism; 4. Although Python has high development efficiency and rich ecosystem, it consumes a high resource, which is suitable for scenarios with low concurrency requirements.
