2012-01-18 17:24:54 -07:00
|
|
|
<!--{
|
2012-02-13 03:22:36 -07:00
|
|
|
"Title": "Getting Started",
|
|
|
|
"Path": "/install/"
|
2012-01-18 17:24:54 -07:00
|
|
|
}-->
|
2009-10-23 16:24:08 -06:00
|
|
|
|
2010-08-24 18:00:50 -06:00
|
|
|
<h2 id="introduction">Introduction</h2>
|
2009-10-23 16:24:08 -06:00
|
|
|
|
2012-02-13 23:02:28 -07:00
|
|
|
<p>
|
|
|
|
Go is an open source project with a BSD-style license.
|
|
|
|
There are two official Go compiler toolchains: the <code>gc</code> Go compiler
|
|
|
|
and the <code>gccgo</code> compiler that is part of the GNU C Compiler (GCC).
|
2009-11-08 23:12:51 -07:00
|
|
|
</p>
|
|
|
|
|
2009-10-23 16:24:08 -06:00
|
|
|
<p>
|
2012-02-13 23:02:28 -07:00
|
|
|
The <code>gc</code> compiler is the more mature and well-tested of the two.
|
|
|
|
This page is about installing a binary distribution of the <code>gc</code>
|
|
|
|
compiler.
|
2009-10-23 16:24:08 -06:00
|
|
|
</p>
|
|
|
|
|
2009-11-05 16:07:42 -07:00
|
|
|
<p>
|
2012-02-13 23:02:28 -07:00
|
|
|
For information about installing the <code>gc</code> compiler from source, see
|
|
|
|
<a href="/install/source/">Installing Go from source</a>.
|
|
|
|
For information about installing <code>gccgo</code>, see
|
|
|
|
<a href="/install/gccgo/">Setting up and using gccgo</a>.
|
2009-11-05 16:07:42 -07:00
|
|
|
</p>
|
|
|
|
|
2012-02-13 23:02:28 -07:00
|
|
|
<h2 id="download">Obtaining the Go tools</h2>
|
2009-11-05 16:07:42 -07:00
|
|
|
|
|
|
|
<p>
|
2012-02-13 23:02:28 -07:00
|
|
|
Visit the
|
|
|
|
<a href="http://code.google.com/p/go/downloads">Go project's downloads page</a>
|
|
|
|
and select the binary distribution that matches
|
|
|
|
your operating system and processor architecture.
|
2009-11-05 16:07:42 -07:00
|
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
2012-02-13 23:02:28 -07:00
|
|
|
Official binary distributions are available
|
|
|
|
for the FreeBSD, Linux, Mac OS X, and Windows operating systems
|
|
|
|
and the 32-bit (<code>386</code>) and 64-bit (<code>amd64</code>)
|
|
|
|
x86 processor architectures.
|
2010-08-24 18:00:50 -06:00
|
|
|
</p>
|
2010-03-10 17:31:09 -07:00
|
|
|
|
2012-02-13 23:02:28 -07:00
|
|
|
<p>
|
|
|
|
If a binary distribution is not available for your
|
|
|
|
OS/arch combination you may want to try
|
|
|
|
<a href="/install/source/">installing from source</a> or
|
|
|
|
<a href="/install/gccgo/">installing gccgo instead of gc</a>.
|
2010-03-10 17:31:09 -07:00
|
|
|
</p>
|
|
|
|
|
2012-02-13 23:02:28 -07:00
|
|
|
<h2 id="install">Installing the Go tools</h2>
|
2009-10-23 16:24:08 -06:00
|
|
|
|
|
|
|
<p>
|
2012-02-13 23:02:28 -07:00
|
|
|
The Go binary distributions assume they will be installed in
|
|
|
|
<code>/usr/local/go</code>, but it is possible to install them in a different
|
|
|
|
location. If you do this, you will need to set the <code>GOROOT</code>
|
|
|
|
environment variable to that directory when using the Go tools.
|
2010-09-15 22:01:02 -06:00
|
|
|
</p>
|
|
|
|
|
2011-02-02 16:53:32 -07:00
|
|
|
<p>
|
2012-02-13 23:02:28 -07:00
|
|
|
For example, if you installed Go to your home directory you should add the
|
|
|
|
following commands to <code>$HOME/.profile</code>:
|
2011-02-02 16:53:32 -07:00
|
|
|
</p>
|
|
|
|
|
2009-10-23 16:24:08 -06:00
|
|
|
<pre>
|
2012-02-13 23:02:28 -07:00
|
|
|
export GOROOT=$HOME/go
|
|
|
|
export PATH=$PATH:$GOROOT/bin
|
2009-10-23 16:24:08 -06:00
|
|
|
</pre>
|
|
|
|
|
2012-02-13 23:02:28 -07:00
|
|
|
<h3 id="freebsd_linux">FreeBSD and Linux</h3>
|
2009-10-23 16:24:08 -06:00
|
|
|
|
2012-02-26 20:16:56 -07:00
|
|
|
<p>
|
|
|
|
On FreeBSD and Linux, if you are upgrading from an older version of Go you must
|
|
|
|
first remove the existing version from <code>/usr/local/go</code>:
|
|
|
|
</p>
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
rm -r /usr/local/go
|
|
|
|
</pre>
|
|
|
|
|
2009-10-23 16:24:08 -06:00
|
|
|
<p>
|
2012-02-13 23:02:28 -07:00
|
|
|
Extract the archive into <code>/usr/local</code>, creating a Go tree in
|
2012-02-26 20:16:56 -07:00
|
|
|
<code>/usr/local/go</code>:
|
2009-10-23 16:24:08 -06:00
|
|
|
</p>
|
|
|
|
|
|
|
|
<pre>
|
2012-02-25 10:40:29 -07:00
|
|
|
tar -C /usr/local -xzf go.release.go1.tar.gz
|
2009-10-23 16:24:08 -06:00
|
|
|
</pre>
|
|
|
|
|
2012-02-26 20:16:56 -07:00
|
|
|
<p>(Typically these commands must be run as root or through <code>sudo</code>.)</p>
|
|
|
|
|
2009-10-23 16:24:08 -06:00
|
|
|
<p>
|
2012-02-13 23:02:28 -07:00
|
|
|
Add <code>/usr/local/go/bin</code> to the <code>PATH</code> environment
|
|
|
|
variable. You can do this by adding this line to your <code>/etc/profile</code>
|
|
|
|
(for a system-wide installation) or <code>$HOME/.profile</code>:
|
2009-10-23 16:24:08 -06:00
|
|
|
</p>
|
|
|
|
|
|
|
|
<pre>
|
2012-02-13 23:02:28 -07:00
|
|
|
export PATH=$PATH:/usr/local/go/bin
|
2009-10-23 16:24:08 -06:00
|
|
|
</pre>
|
|
|
|
|
2012-02-13 23:02:28 -07:00
|
|
|
<h3 id="osx">Mac OS X</h3>
|
2009-10-23 16:24:08 -06:00
|
|
|
|
|
|
|
<p>
|
2012-02-13 23:02:28 -07:00
|
|
|
Open the <code>.pkg</code> file and follow the prompts to install the Go tools.
|
|
|
|
The package installs the Go distribution to <code>/usr/local/go</code>.
|
2009-10-23 16:24:08 -06:00
|
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
2012-02-13 23:02:28 -07:00
|
|
|
The package should put the <code>/usr/local/go/bin</code> directory in your
|
|
|
|
<code>PATH</code> environment variable. You may need to restart any open
|
|
|
|
Terminal sessions for the change to take effect.
|
2009-10-23 16:24:08 -06:00
|
|
|
</p>
|
|
|
|
|
2012-02-13 23:02:28 -07:00
|
|
|
<h3 id="windows">Windows</h3>
|
|
|
|
|
2009-10-23 16:24:08 -06:00
|
|
|
<p>
|
2012-02-13 23:02:28 -07:00
|
|
|
<font color="red">TODO: windows installation instructions.</font>
|
2009-10-23 16:24:08 -06:00
|
|
|
</p>
|
|
|
|
|
2012-02-13 23:02:28 -07:00
|
|
|
<h2 id="testing">Testing your installation</h2>
|
2009-10-23 16:24:08 -06:00
|
|
|
|
|
|
|
<p>
|
2012-02-13 23:02:28 -07:00
|
|
|
Check that Go is installed correctly by building a simple program, as follows.
|
2009-10-23 16:24:08 -06:00
|
|
|
</p>
|
|
|
|
|
2012-02-13 23:02:28 -07:00
|
|
|
<p>
|
|
|
|
Create a file named <code>hello.go</code> and put the following program in it:
|
2009-10-23 16:24:08 -06:00
|
|
|
</p>
|
|
|
|
|
|
|
|
<pre>
|
|
|
|
package main
|
|
|
|
|
|
|
|
import "fmt"
|
|
|
|
|
|
|
|
func main() {
|
2012-02-13 23:02:28 -07:00
|
|
|
fmt.Printf("hello, world\n")
|
2009-10-23 16:24:08 -06:00
|
|
|
}
|
|
|
|
</pre>
|
|
|
|
|
|
|
|
<p>
|
2012-02-13 23:02:28 -07:00
|
|
|
Then run it with the <code>go</code> tool:
|
2009-10-23 16:24:08 -06:00
|
|
|
</p>
|
|
|
|
|
2012-02-13 23:02:28 -07:00
|
|
|
<pre>
|
|
|
|
$ go run hello.go
|
|
|
|
hello, world
|
|
|
|
</pre>
|
|
|
|
|
2009-10-23 16:24:08 -06:00
|
|
|
<p>
|
2012-02-13 23:02:28 -07:00
|
|
|
If you see the "hello, world" message then your Go installation is working.
|
2009-10-23 16:24:08 -06:00
|
|
|
</p>
|
2010-09-15 22:01:02 -06:00
|
|
|
|
|
|
|
<h2 id="next">What's next</h2>
|
|
|
|
|
|
|
|
<p>
|
2011-10-05 12:12:07 -06:00
|
|
|
Start by taking <a href="http://code.google.com/p/go-tour/">A Tour of Go</a>
|
2012-02-19 14:08:30 -07:00
|
|
|
or reading the <a href="/doc/go_tutorial.html">Go Tutorial</a>.
|
2010-09-15 22:01:02 -06:00
|
|
|
</p>
|
|
|
|
|
2012-02-13 23:02:28 -07:00
|
|
|
<p>
|
|
|
|
For more detail about the process of building and testing Go programs
|
|
|
|
read <a href="/doc/code.html">How to Write Go Code</a>.
|
|
|
|
</p>
|
|
|
|
|
2010-09-15 22:01:02 -06:00
|
|
|
<p>
|
2012-02-26 17:25:43 -07:00
|
|
|
Build a web application by following the <a href="/doc/articles/wiki/">Wiki
|
|
|
|
Tutorial</a>.
|
2010-09-15 22:01:02 -06:00
|
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
2012-02-20 20:12:07 -07:00
|
|
|
Read <a href="/doc/effective_go.html">Effective Go</a> to learn about writing
|
2010-09-15 22:01:02 -06:00
|
|
|
idiomatic Go code.
|
|
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
|
|
For the full story, consult Go's extensive
|
2012-02-20 20:12:07 -07:00
|
|
|
<a href="/doc/">documentation</a>.
|
2010-09-15 22:01:02 -06:00
|
|
|
</p>
|
2009-11-09 00:38:30 -07:00
|
|
|
|
2011-03-16 23:33:10 -06:00
|
|
|
|
2010-08-24 18:00:50 -06:00
|
|
|
<h2 id="community">Community resources</h2>
|
2009-11-09 00:38:30 -07:00
|
|
|
|
|
|
|
<p>
|
|
|
|
For real-time help, there may be users or developers on
|
|
|
|
<code>#go-nuts</code> on the <a href="http://freenode.net/">Freenode</a> IRC server.
|
|
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
|
|
|
The official mailing list for discussion of the Go language is
|
|
|
|
<a href="http://groups.google.com/group/golang-nuts">Go Nuts</a>.
|
|
|
|
</p>
|
|
|
|
|
|
|
|
<p>
|
2012-02-13 23:02:28 -07:00
|
|
|
Bugs should be reported using the
|
|
|
|
<a href="http://code.google.com/p/go/issues/list">Go issue tracker</a>.
|
2010-08-24 18:00:50 -06:00
|
|
|
</p>
|