Primeros pasos

Puedes ver el documento original aquí

Descarga la distribución Go

Descarga Go — Haz clic aquí para visitar la página de descargas

Disponemos de distribuciones binarias oficiales para FreeBSD (versión 8-STABLE y superiores), sistemas operativos Linux, Mac OS X (Snow Leopard y superiores) y arquitecturas Windows con procesador x86 de 32 bits (386) y 64 bits (amd64).

Si una distribución binaria no está disponible para tu combinación de sistema operativo y arquitectura, intenta con la instalación desde fuente o instala gccgo en lugar de gc.

Requisitos del sistema

El compilador gc es compatible con los siguientes sistemas operativos y arquitecturas. Por favor, asegúrate de que tu sistema cumple estos requisitos antes de proceder. Si tu sistema operativo o arquitectura no está en la lista, es posible que gccgo pueda apoyar tu configuración; ve los detalles de configuración y uso de gccgo.

Sistema operativo Arquitecturas Notas
FreeBSD 8-STABLE o superior amd64, 386, arm Debian GNU/kFreeBSD no soportado; FreeBSD/ARM necesita FreeBSD 10 o posterior
Linux 2.6.23 o posterior con glibc amd64, 386, arm CentOS/RHEL 5.x no soportado; aún no hay una distribución binaria para ARM
Mac OS X 10.6 o posterior amd64, 386 Utiliza el gcc † que viene con Xcode ‡
Windows XP o posterior amd64, 386 Utiliza MinGW gcc †. No necesitas cygwin o msys.

† gcc sólo se requiere si vas a utilizar CGO.

‡ Sólo necesitas instalar las herramientas de línea de órdenes para Xcode. Si ya tienes instalado Xcode 4.3 +, lo puedes instalar desde la ficha Componentes del Panel de preferencias de descarga.

Instalando las herramientas Go

Si estás actualizando desde una versión anterior de Go primero debes quitar la versión existente.

Linux, Mac OS X y archivos comprimidos para FreeBSD

Descarga el archivo y extraelo en /usr/local, creando un árbol Go en /usr/local/go. Por ejemplo:

tar -C /usr/local -xzf go$VERSION.$OS-$ARCH.tar.gz

Elije el archivo apropiado para tu instalación. Por ejemplo, si vas a instalar Go versión 1.4.2 para 64-bits x86 en Linux, el archivo que deseas se llama go1.4.2.linux-amd64.tar.gz.

(Normalmente estas órdenes se deben ejecutar como root o por medio de sudo).

Añade /usr/local/go/bin a la variable de entorno PATH. Lo puedes hacer añadiendo esta línea a tu /etc/profile (para una instalación en todo el sistema) o $HOME/.profile:

export PATH=$PATH:/usr/local/go/bin

Instalación en una ubicación personalizada

Las distribuciones binarias de Go asumen que se instalarán en /usr/local/go (o c:\Go en Windows), pero es posible instalar las herramientas de go en un lugar diferente. En ese caso, debes establecer la variable de entorno GOROOT para que apunte al directorio en el que lo hayas instalado.

Por ejemplo, si instaláste Go en tu directorio home debes agregar las siguientes órdenes a $HOME/.profile:

export GOROOT=$HOME/go
export PATH=$PATH:$GOROOT/bin

Nota:: GOROOT se debe establecer sólo cuando se instala en una ubicación personalizada.

Instalador de paquetes Mac OS X

Descarga el archivo del paquete, ábrelo y sigue las instrucciones para instalar las herramientas Go. El paquete instala la distribución Go en /usr/local/go.

El paquete debe poner el directorio /usr/local/go/bin en tu variable de entorno PATH. Posiblemente tengas que reiniciar cualquier sesión de terminal abierta para que el cambio surta efecto.

Windows

El proyecto Go ofrece dos opciones de instalación para los usuarios de Windows (además la instalación desde fuente): un archivo zip que requiere que establezcas algunas variables de entorno y un instalador MSI que configura tu instalación automáticamente.

Instalador MSI

Abre el archivo MSI y sigue las instrucciones para instalar las herramientas Go. De manera predeterminada, el instalador pone la distribución Go en c:\Go.

El instalador debe poner el directorio c:\Go\bin en tu variable de entorno PATH. Posiblemente tengas que reiniciar cualquier sesión abierta para que el cambio surta efecto.

Archivo zip

Descarga el archivo zip y extraelo en el directorio de tu elección (sugerimos c:\Go).

Si eliges un directorio distinto de c:\Go, debes establecer la variable de entorno GOROOT a la ruta elegida.

Añade el subdirectorio bin de tu Go raíz (por ejemplo, c:\Go\bin) a tu variable de entorno PATH.

Configurando las variables de entorno en Windows

En Windows, puedes establecer las variables de entorno a través del botón "Variables de entorno" en la ficha "Avanzado" del panel de control "Sistema". Algunas versiones de Windows proporcionan este panel de control a través de "Configuración Avanzada del Sistema" dentro de la opción "Configuración del sistema" del panel de control.

Probando tu instalación

Verifica que Go está instalado correctamente construyendo un sencillo programa, de la siguiente manera.

Crea un archivo llamado hola.go y pon el siguiente código en él:

package main

import "fmt"

func main() {
    fmt.Printf("hola, mundo\n")
}

Luego ejecútalo con la herramienta go:

$ go run hola.go
hola, mundo

Si ves el mensaje "hola, mundo" entonces tu instalación de Go está trabajando.

Configura tu ambiente de trabajo

Casi terminas. Solo necesitas configurar tu entorno.

Lee el documento Cómo escribir código Go, que proporciona instrucciones de configuración esenciales para el uso de las herramientas Go.

Desinstalando Go

Para eliminar de tu sistema una instalación de Go existente borra el directorio Go. Este suele ser /usr/local/go bajo Linux, Mac OS X y FreeBSD o c:\Go bajo Windows.

También debes eliminar el directorio go/bin de tu variable de entorno PATH. Bajo Linux y FreeBSD deberías editar /etc/profile o $HOME/.profile. Si instalaste Go con el paquete Mac OS X luego debes quitar el archivo /etc/paths.d/go. Los usuarios de Windows deben leer la sección sobre ajuste de las variables de entorno bajo Windows.

Consiguiendo ayuda

Para ayuda en tiempo real, pregunta a los serviciales gophers en el canal #go-nuts del servidor IRC Freenode.

La lista de correo oficial para discusión del lenguaje Go es Go Nuts.

Informa los errores utilizando el gestor de incidencias Go.

En su mayor parte este libro se reproduce a partir del trabajo creado y compartido por Google traducido al Español y se usa de acuerdo a los términos descritos en la Licencia Creative Commons 3.0 Attribution, el código se libera bajo una licencia estilo BSD.