Overview
go is the one command for Go work: it compiles programs (go build), runs them (go run), tests them (go test), checks them (go vet) and manages the modules that a project depends on (go mod). A Go project is a folder with a go.mod file that names the module and its dependencies.
Background
go is the command of the Go toolchain, and its manual is on pkg.go.dev. The examples work in a temporary folder with no network. The tool tested here is Go 1.27.3.
Examples
Print the installed version; reviewed only, because the output changes with each release:
go version
Run a small program from one file with go run:
printf 'package main\nimport "fmt"\nfunc main(){fmt.Println("hi")}\n' > main.go && go run main.go
Start a module with go mod init; the first line of go.mod names it:
go mod init demo > /dev/null 2>&1 && head -n 1 go.mod
Build a program to a file and run the file:
printf 'package main\nimport "fmt"\nfunc main(){fmt.Println("hi")}\n' > main.go && go mod init demo > /dev/null 2>&1 && go build -o hello . && ./hello
Check a package for suspicious code with go vet; the status is 0 when it finds nothing:
printf 'package main\nfunc main(){}\n' > main.go && go mod init demo > /dev/null 2>&1 && go vet ./... && echo vet-ok
Subcommands
go build compiles the package. go run compiles and runs a program. go test runs the tests. go vet reports suspicious code. go mod manages modules, as in go mod init and go mod tidy.
Common mistakes
The first line of a program must be package main and it needs a main function, or go run says it cannot run a package. Run go commands in the folder that holds go.mod, or tell it with -C. Downloading modules needs the network, and the files go to a cache shared by all your projects. go run builds to a temporary place each time, so use go build for a program you run often. A newer go may download a different toolchain, as the toolchain line of go.mod asks.
Portability
The commands are the same on every system; new language features come with new versions. The examples that build and run code were executed on Go 1.27.3; the version example is reviewed only. The Common examples were executed on Go 1.27.3 (see the development guide for the exact check).
About upstream go
This is the upstream go tool. It is one program everywhere; what differs is the version.
References
Original explanations, with upstream documentation for further reading. FreeBSD references are comparison material, not a claim of Apple version equivalence.