Go: Install the Go programming language (with multiple versions + installing binaries)

Tags: #go #install

golang install instructions.md

UPDATE

Otherwise, for all the gory details see the following…

Install Go

You can either download the latest release from https://golang.org/doc/install or a specific release, e.g. https://go.dev/dl/go1.18.1.darwin-arm64.pkg.

NOTE: Test on Docker using: docker run -v $(pwd):/go-project-to-build -it ubuntu bash

apt-get update
apt-get install -y wget
wget -c https://golang.org/dl/go1.22.0.linux-amd64.tar.gz
tar -C /usr/local -xvzf go1.22.0.linux-amd64.tar.gz
/usr/local/go/bin/go version
export PATH="/usr/local/go/bin:$PATH"
go version
export PATH="~/go/bin:$PATH" # for handling `go install`ed binaries

The installation directory will be: /usr/local/go.

Once you have Go installed, you can then use the go command to either install go based tools/binaries or other versions of Go (see below).

NOTE: Additionally, you can automate the install via a terminal using the following shell function:

# you can swap `ag` for `grep` if you prefer less dependencies
alias golatest="curl -L https://github.com/golang/go/tags 2>&1 | ag '/golang/go/releases/tag/go[\w.]+' -o | cut -d '/' -f 6 | awk NR==1 | ag '\d.+' -o"

function go_install {
  if [ -z "$1" ]; then
    echo USAGE: go_install 1.18.1 OR go_install \$\(golatest\)
    return
  fi
  v=$1
  osname=$(uname -s | tr '[:upper:]' '[:lower:]')
  hardware=$(uname -m)
  mkdir -p ~/goversions
  if ! test -f "~/goversions/go$v.$osname-$hardware.pkg"; then
    printf "\nDownloading %s\n\n" "go$v.$osname-$hardware"
    curl -L -o ~/goversions/go$v.$osname-$hardware.pkg https://go.dev/dl/go$v.$osname-$hardware.pkg
  fi
  echo ""
  sudo rm -rf /usr/local/go; sudo installer -pkg ~/goversions/go$v.$osname-$hardware.pkg -target /usr/local/
  clear
  go version
}

Installing binaries

As of version go 1.16 go install is now responsible only for installing binaries, not modifying a go.mod file (that’s what go get is for).

go install example.com/cmd@v1.0.0
go install example.com/cmd@latest

NOTE: See reference documentation.

Installing different go versions

The following is the ‘official’ approach…

https://go.dev/doc/manage-install#installing-multiple

go install golang.org/dl/go1.18@latest
go1.18 download
go1.18 version # go version go1.18 darwin/amd64
alias go=go1.18

# if you want a simple binary overwrite of the global go
go install golang.org/dl/go1.18@latest
go1.18 download
sudo cp $(which go1.18) $(which go) # requires sudo as it's copying into /usr/local/...

# latest (tip) with additional/unreleased feature
go install golang.org/dl/gotip
gotip download dev.fuzz # also download a dev/tip specific tool/feature
gotip test -fuzz=FuzzFoo

NOTE: If using version of go < 1.16 you’ll need to use go get instead of go install.

Basic switcher using `go.mod` as reference

# This function identifies the go version specified in a project's go.mod
# It then attempts to switch to a binary of that version.
# If none exists it will instruct you how to download it.
#
# NOTE: Some tools, e.g. TinyGo, won't work with this approach because we're
# just replacing the go binary and the VERSION file, where the originally
# installed version of go will have things like CGO files that TinyGo will try
# to use and if those don't align with the version of the binary we've switched
# to, then it means TinyGo will fail to compile. 
#
# In that scenario you're better off using the `go_install` shell function 
# approach at the top of the page.
function go_version {
    if [ -f "go.mod" ]; then
        v=$(grep -E '^go \d.+$' ./go.mod | grep -oE '\d.+$')
        if [[ ! $(go version | grep "go$v") ]]; then
          echo ""
          echo "About to switch go version to: $v"
          if ! command -v "$HOME/go/bin/go$v" &> /dev/null
          then
            echo "run: go install golang.org/dl/go$v@latest && go$v download && sudo cp \$(which go$v) \$(which go)"
            return
          fi
          sudo cp $(which go$v) $(which go)
          echo -n go$v | sudo tee $(dirname $(dirname $(which go)))/VERSION > /dev/null
        fi
    fi
}

# To support the configuring our go environment we will override the cd
# command to call the go logic for checking the go version.
#
# NOTE: We use `command` and not `builtin` because the latter doesn't take into
# account anything available on the user's $PATH but also because it didn't
# work with the Starship prompt which seems to override cd also.
function cd {
  command cd "$@"
  RET=$?
  go_version
  return $RET
}

Unofficial: goenv

https://github.com/syndbg/goenv

The nice thing about goenv is that it lets you more easily automate a switch between projects using either GOENV_VERSION or .go-version (docs).

Linux

sudo apt-get update
sudo apt-get upgrade # this takes a LONG time
sudo apt-get install golang-go

wget https://dl.google.com/go/go1.17.2.linux-amd64.tar.gz
sudo tar -xvf go1.17.2.linux-amd64.tar.gz # this takes a LONG time
sudo mv go /usr/local

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$GOPATH/bin:$GOROOT/bin:$PATH

source ~/.bashrc

wget -c https://golang.org/dl/go1.22.1.linux-amd64.tar.gz
sudo tar -C /usr/local -xvzf go1.22.1.linux-amd64.tar.gz
export PATH=/usr/local/go/bin:$PATH