Table of Contents
Using Mutex for Thread-Safe Counter
Using Atomic Operations
When to Use Mutex vs Atomic
Home Backend Development Golang How to implement a thread-safe counter in Go?

How to implement a thread-safe counter in Go?

Jul 20, 2025 am 12:05 AM

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.

How to implement a thread-safe counter in Go?

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.

How to implement a thread-safe counter in Go?

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:

How to implement a thread-safe counter in Go?
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:

How to implement a thread-safe counter in Go?
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 or int64, 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!

Statement of this Website
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn

Hot AI Tools

Undress AI Tool

Undress AI Tool

Undress images for free

Undresser.AI Undress

Undresser.AI Undress

AI-powered app for creating realistic nude photos

AI Clothes Remover

AI Clothes Remover

Online AI tool for removing clothes from photos.

Clothoff.io

Clothoff.io

AI clothes remover

Video Face Swap

Video Face Swap

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

Hot Tools

Notepad++7.3.1

Notepad++7.3.1

Easy-to-use and free code editor

SublimeText3 Chinese version

SublimeText3 Chinese version

Chinese version, very easy to use

Zend Studio 13.0.1

Zend Studio 13.0.1

Powerful PHP integrated development environment

Dreamweaver CS6

Dreamweaver CS6

Visual web development tools

SublimeText3 Mac version

SublimeText3 Mac version

God-level code editing software (SublimeText3)

Strategies for Integrating Golang Services with Existing Python Infrastructure Strategies for Integrating Golang Services with Existing Python Infrastructure Jul 02, 2025 pm 04:39 PM

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

Understanding the Performance Differences Between Golang and Python for Web APIs Understanding the Performance Differences Between Golang and Python for Web APIs Jul 03, 2025 am 02:40 AM

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

Is golang frontend or backend Is golang frontend or backend Jul 08, 2025 am 01:44 AM

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.

How to completely and cleanly uninstall Golang from my system? How to completely and cleanly uninstall Golang from my system? Jun 30, 2025 am 01:58 AM

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

How to marshal a golang struct to JSON with custom field names? How to marshal a golang struct to JSON with custom field names? Jun 30, 2025 am 01:59 AM

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""

How to install Go How to install Go Jul 09, 2025 am 02:37 AM

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

How to fix 'go: command not found' after installation? How to fix 'go: command not found' after installation? Jun 30, 2025 am 01:54 AM

"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.

Resource Consumption (CPU/Memory) Benchmarks for Typical Golang vs Python Web Services Resource Consumption (CPU/Memory) Benchmarks for Typical Golang vs Python Web Services Jul 03, 2025 am 02:38 AM

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.

See all articles