Documentation

The Go programming language is an open source project to make programmers more productive.

Go is expressive, concise, clean, and efficient. Its concurrency mechanisms make it easy to write programs that get the most out of multicore and networked machines, while its novel type system enables flexible and modular program construction. Go compiles quickly to machine code yet has the convenience of garbage collection and the power of run-time reflection. It's a fast, statically typed, compiled language that feels like a dynamically typed, interpreted language.

Getting started

Instructions for downloading and installing Go.

A brief Hello, World tutorial to get started. Learn a bit about Go code, tools, packages, and modules.

A tutorial of short topics introducing functions, error handling, arrays, maps, unit testing, and compiling.

Learning Go

An interactive introduction to Go in three sections. The first section covers basic syntax and data structures; the second discusses methods and interfaces; and the third introduces Go's concurrency primitives. Each section concludes with a few exercises so you can practice what you've learned. You can take the tour online or install it locally with:

$ go get golang.org/x/tour

This will place the tour binary in your workspace's bin directory.

This doc explains how to develop a simple set of Go packages inside a module, and it shows how to use the go command to build and test packages.

A document that summarizes commonly used editor plugins and IDEs with Go support.

A document that gives tips for writing clear, idiomatic Go code. A must read for any new Go programmer. It augments the tour and the language specification, both of which should be read first.

Summarizes tools and methodologies to diagnose problems in Go programs.

Answers to common questions about Go.

A list of tutorials to get started with Go.

A wiki maintained by the Go community.

More

See the Learn page at the Wiki for more Go learning resources.

References

The documentation for the Go standard library.

The documentation for the Go tools.

The official Go Language specification.

A document that specifies the conditions under which reads of a variable in one goroutine can be guaranteed to observe values produced by writes to the same variable in a different goroutine.

A summary of the changes between Go releases.

Articles

The official blog of the Go project, featuring news and in-depth articles by the Go team and guests.

Codewalks

Guided tours of Go programs.

Language

Packages

Modules

Tools

More

See the Articles page at the Wiki for more Go articles.

Talks

Three things that make Go fast, fun, and productive: interfaces, reflection, and concurrency. Builds a toy web crawler to demonstrate these.

One of Go's key design goals is code adaptability; that it should be easy to take a simple design and build upon it in a clean and natural way. In this talk Andrew Gerrand describes a simple "chat roulette" server that matches pairs of incoming TCP connections, and then use Go's concurrency mechanisms, interfaces, and standard library to extend it with a web interface and other features. While the function of the program changes dramatically, Go's flexibility preserves the original design as it grows.

Concurrency is the key to designing high performance network services. Go's concurrency primitives (goroutines and channels) provide a simple and efficient means of expressing concurrent execution. In this talk we see how tricky concurrency problems can be solved gracefully with simple Go code.

This talk expands on the Go Concurrency Patterns talk to dive deeper into Go's concurrency primitives.

More

See the Go Talks site and wiki page for more Go talks.

Non-English Documentation

See the NonEnglish page at the Wiki for localized documentation.