A Comprehensive Guide on How to Install Golang on macOS

golang macos

Installing Go (also known as Golang) on your macOS system is a crucial step to embark on your journey of becoming a proficient Go developer. Go is an open-source programming language developed by Google, known for its simplicity, performance, and efficiency. In this tutorial, we will walk you through the step-by-step process on how to install Golang on macOS, ensuring a smooth setup for your Golang development environment.

Before we dive into the installation process, make sure you have the following prerequisites in place:

  1. A macOS system (macOS 10.11 or later recommended).
  2. A stable internet connection.
  3. Terminal application (pre-installed on macOS).

Downloading the Go Package:

The first step is to download the official Go distribution package for macOS. Follow these steps:

  1. Open your preferred web browser and navigate to the official Go Downloads page
  2. Look for the macOS package and click on the download link to save the package file to your system.

Installing Go:

Once the package is downloaded, follow these steps to install Go on your macOS:

  1. Locate the downloaded package file (usually named something like goX.Y.Z.darwin-amd64.pkg).
  2. Double-click on the package file to initiate the installation process.
  3. Follow the on-screen instructions to complete the installation. You may need to provide your system password to authorize the installation.
  4. The installer will set up Go in the default location (/usr/local/go). This location is recommended, but you can choose a different location if needed.

Setting Up Go Paths:

After installing Go, you need to configure the Go paths to ensure that your system can locate the Go binaries and libraries. Follow these steps:

Open the Terminal application (you can find it in the Applications folder or search using Spotlight).

To set the GOPATH environment variable, add the following line to your shell profile configuration file (usually ~/.bash_profile, ~/.zshrc, or ~/.bashrc):

export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

Note: Replace the shell profile file name with the one you are using (e.g., ~/.zshrc for the Zsh shell).

Save the changes and exit the text editor.

To apply the changes, either restart your terminal or run the command source ~/.bash_profile (or the corresponding file for your shell).

Verifying the Installation:

To verify that Go has been successfully installed, follow these steps:

  1. Open a new terminal window.
  2. Run the command go version. You should see the installed Go version displayed in the output.

Congratulations! You have successfully installed Go on your macOS system. You’re now ready to start writing and running Go programs.


In this tutorial, we’ve walked through the process of installing Go on macOS, from downloading the package to verifying the installation. Setting up Go on your system is a fundamental step in your journey to becoming a skilled Go developer. With Go up and running on your macOS, you’re well-equipped to explore the language’s features, libraries, and tools, and to start building efficient and powerful applications.

Stay tuned for more Golang tutorials and tips to enhance your development skills. Happy coding!

Leave a Reply

Your email address will not be published. Required fields are marked *

Post comment