Para que el compilador de Go transforme tu código en un archivo que puedas ejecutar (como un .exe en Windows), no basta con escribir instrucciones; necesitas seguir una estructura de “punto de entrada”. Un programa en Go es, en esencia, una colección de archivos organizados en packages (paquetes). Mientras que un paquete puede tener cualquier nombre cuando creas una librería para que otros la usen, existe un nombre especial: package main. Solo si declaras tu paquete como main, el enlazador (el componente que une todas las piezas del código) entenderá que tu intención es crear un ejecutable independiente y no una biblioteca de funciones.
Dentro de ese package main, el runtime de Go busca una función llamada func main(). Esta función es el corazón de tu programa; es el lugar exacto donde la ejecución comienza. Es fundamental entender que main es extremadamente estricta: no puede recibir argumentos (como strings de la terminal) ni devolver valores (como un número de error). Su única responsabilidad es arrancar la lógica de tu aplicación. Si intentas definir func main(args string), el compilador fallará porque la firma de la función no coincide con lo que el sistema operativo espera para iniciar un proceso.
Cuando ejecutas el comando go run main.go, Go realiza un proceso invisible pero crucial: no ejecuta tu archivo de texto directamente. Lo que hace es compilar tu código en una carpeta temporal del sistema, genera un binario real (un archivo ejecutable) en ese lugar, lo ejecuta y, una vez que tu programa termina, borra ese binario temporal para no dejar basura en tu disco.
Un detalle que suele confundir al principio es la relación entre archivos y carpetas. En Go, el package es la unidad lógica de código, pero el directorio es la unidad física en tu disco. La convención es estricta: un directorio representa un único paquete. Si tienes dos archivos en la misma carpeta, ambos deben declarar el mismo nombre de package al principio; de lo contrario, el compilador se perderá al intentar entender cómo se relacionan.
package main
import "fmt"
// La función main es el punto de entrada del ejecutable.
// No acepta parámetros ni devuelve valores.
func main() {
// fmt es un paquete estándar que provee funciones para
// formatear texto y manejar la entrada/salida.
fmt.Println("Hola, mundo desde un ejecutable de Go.")
}
En este ejemplo, la primera línea package main le indica al compilador que este código tiene como objetivo producir un archivo ejecutable. La palabra main es la clave aquí.
Luego, utilizamos import "fmt". Esto le dice a Go que necesitamos traer las capacidades del paquete fmt (abreviatura de format), que viene incluido con el lenguaje. Sin esta línea, el compilador no sabría qué es fmt cuando intentamos usarlo.
Dentro de func main(), llamamos a fmt.Println(...). Aquí estamos accediendo a la función Println que reside dentro del paquete fmt. El programa se ejecuta de arriba hacia abajo: entra en main, ejecuta la impresión en consola, y cuando llega a la llave de cierre }, el programa termina exitosamente.
El error frecuente
Un error muy común cuando se viene de otros lenguajes es intentar pasar parámetros directamente a la función main para recibir argumentos de la terminal, como harías en C o Java:
// ESTO NO COMPILARÁ
package main
func main(args []string) {
// Error: func main must have no arguments
}
Si necesitas leer argumentos que el usuario escribe al ejecutar tu programa (por ejemplo, go run main.go --nombre=Juan), no debes modificar la firma de main. En su lugar, debes importar el paquete os y usar os.Args dentro de la función main para capturar esos valores. La función main siempre debe ser limpia de parámetros para que el runtime pueda arrancarla sin conflictos.
N° 12