Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
- This wiki is open to editing by any member of the Go community with a GitHub account.
- If you would like to add a new page, please first open an issue in the Go issue tracker with the prefix 'wiki' to propose the addition. Clearly state why the content does not fit into any of the existing pages.
- Because renaming of pages in the wiki can break external links, please open an issue before renaming or removing any wiki page.
Table of Contents
- Getting started with Go
- Working with Go
- Learning more about Go
- The Go Community
- Using the go toolchain
- Additional Go Programming Wikis
- Online Services that work with Go
- Troubleshooting Go Programs in Production
- Contributing to the Go Project
- Platform Specific Information
- Release Specific Information
Getting started with Go
- The Go Tour is the best place to start.
- Effective Go will help you learn how to write idiomatic Go code.
- Go standard library documentation to familiarize yourself with the standard library.
- Use the Go Playground to test out Go programs in your browser.
- Still not convinced? Check out this list of Go Users and a few of their Success stories. We've also assembled a long list of reasons why you should give Go a try.
- Read about the companies which have switched from other languages to Go.
Working with Go
Ready to write some Go code of your own? Here are a few links to help you get started.
- Install and Setup your Environment
- Start here: Official Installation Documentation
- If you prefer to install from source, read this first.
- InstallFromSource - Additional tips on source installs.
- Windows user? Install and configure Go, Git and Atom for Windows
- Mac user? How I start - Go - A step-by-step guide to installing Go and building your first web service.
- Having installation problems? InstallTroubleShooting
- Make sure you have your $GOPATH environment variable set correctly
- If you need additional tips on using $GOPATH, go here.
MultipleGoRoots - More advanced information on working with multiple go installations and the
- Go IDEs and Editors - Information on how to use your favorite editor with Go.
- Tools for working with Go code - Formatting, linting, vetting, refactoring, navigation and visualization.
- Finding Go Libraries and Packages
- Managing your dependencies - An overview of the tools you can use to manage third-party packages (vendoring).
- Publishing Go Packages as Open Source
Learning more about Go
Once you have an overview of the language, here are resources you can use to learn more.
- Learning Go - A collection of resources for learning Go - beginner to advanced.
- Books - A list of Go books that have been published (ebook, paper)
Blogs - Blogs about Go
- Podcasts - Podcasts and episodes featuring Go
- Videos, Talks and Presentations
- Articles - A collection of articles to help you learn more about Go.
- Training - Free and commercial, online and classroom training for Go.
- University Courses - A list of CS programs and classes using Go.
- Resources for non-English speakers
The Go Community
Here are some of the places where you can find Gophers online. To get a sense of what it means to be a member of the Go community, read Damian Gryski's keynote from the GolankUK 2015 conference or watch Andrew Gerrand's closing keynote from GopherCon 2015.
- Where Gophers hangout online:
- The Go Forum - An all-purpose discussion forum for the Go community.
- Gophers Slack Channel - For real-time chat (request membership).
- Golang News - For curated links about Go Programming.
- There is also a /r/golang sub-reddit.
- On Twitter, follow the @golang account and keep tabs on the #golang hashtag.
- We've also got a landing page on Stack Overflow for Go Q&A.
- Matrix enthusiasts are invited to join #Go:matrix.org.
- Discord users are welcome at the Discord Gophers server.
- Mailing Lists
- The mailing list for Go users is golang-nuts - very high traffic.
- For discussions about the core Go open source project, join golang-dev.
- To get just our release announcements, join golang-announce
- User Groups & Meetups - There are Go Meetups in many cities
- Conferences - A list of upcoming and past Go conferences and major events.
- Companies using Go - A comprehensive list of companies using Go throughout the world.
- Learn more about the Go Gopher images by Renee French.
Using the go toolchain
- Start with the standard documentation for the
gocommand available here
- Start here for to learn about vendoring.
- See also PackageManagementTools for package management tools.
- Cross Compilation
- Shared libraries and Go (buildmode)
- Go Shared Libraries - Examples for creating and using shared libraries from Go and Python.
- Sharing Go Packages with C - by @ralch.
- Calling Go libraries from Python - by Filippo Valsorda
- Calling Go libraries from Ruby - by Peter Hellberg
- Calling Go libraries from Swift - by Jaana Burcu Dogan
- Build a Ruby Gem with a Go native extension - by @jondot
- gohttplib - An experiment in using Go 1.5 buildmode=c-shared.
- See the wikis below for additional details:
Additional Go Programming Wikis
- Why Go doesn't Support Generics: A Summary of Go Generics Discussions - Start here before you join the debate.
- Working with Databases
- From other languages
Online Services that work with Go
If you're looking for services that support Go, here's a list to get you started.
- Cloud Computing - Go is well supported on most cloud service providers.
- Continuous Integration and Continuous Deployment - Go is well supported by most CI/CD frameworks
- Package and Dependency Management
- Gopkg.in is a source for stable Go libraries, provided by Gustavo Niemeyer.
Troubleshooting Go Programs in Production
- Understand the performance of your Go apps using the pprof package
- Heap Dumps
Contributing to the Go Project
- Start by reading the Go Contribution Guidelines
- If you'd like to propose a change to the Go project, start by reading the Go Change Proposal Process
- An archive of design documents is also available
- Go releases happen on ~6 month intervals. See here for more information
- Want to know more about how the Go source sub-repositories are structured?
- The Go project requires that all code be reviewed before it is submitted.
- Project Dashboards
Platform Specific Information
- See MinimumRequirements for minimum platform requirements of current Go ports.
- Considering porting Go to a new platform? Read our porting policy first
- DragonFly BSD
- Plan 9
Release Specific Information
- Please refrain from changing the title of the wiki pages, as some of them might be linked to from golang.org or other websites.