Go reclama do go.mod? Por que isso acontece e como funciona

Introdução: O medo familiar de todo iniciante em Go

Você acabou de começar a estudar Go. A inspiração transborda, você escreve seu primeiro Hello, World!, executa go run main.go — e em vez de uma saudação, vê uma parede vermelha de texto. A frase-chave que faz o coração gelar: "go: go.mod file not found in current directory or any parent directory; see 'go help modules'".

Familiar? Não se preocupe, todo mundo que começou a trabalhar com Go após a versão 1.11 já viu esse erro. Não é um bug do compilador nem uma maldição dos deuses antigos. É um mecanismo rigoroso, mas justo, do sistema de módulos do Go. Hoje, não vamos apenas mostrar como corrigi-lo (embora também faremos isso). Vamos olhar "sob o capô": entender por que o Go exige o go.mod, como ele o procura e o que acontece se o arquivo não existir.

Ao final do artigo, você não apenas se livrará do erro, mas também entenderá a própria filosofia de gerenciamento de dependências em Go. Vamos lá!

O que é go.mod e para que serve no Go?

Imagine que o go.mod é o passaporte do seu projeto. Neste arquivo, o Go armazena três coisas principais:

\n
• O nome do módulo (por exemplo, example.com/myproject) — um identificador único.
\n
• A versão do Go na qual o projeto foi escrito.
\n
• A lista de dependências — quais pacotes externos você está usando e suas versões exatas.
\n

Antes do surgimento dos módulos (nas versões do Go < 1.11), tudo era diferente. O código precisava ser armazenado estritamente dentro da pasta $GOPATH/src. Isso era inconveniente: você não podia simplesmente clonar um repositório em qualquer pasta e executá-lo. O sistema de módulos (Go modules) resolveu esse problema, tornando os projetos portáteis e isolados.

Agora, o Go vê o go.mod como a fronteira do projeto. Se o arquivo não existir, o Go considera que você está trabalhando fora de um projeto e se recusa a executar o código. Essa é a raiz do nosso erro.

Como o Go procura o go.mod: algoritmo "de baixo para cima"

Quando você digita go run main.go, o Go inicia uma busca pelo go.mod seguindo este algoritmo:

\n
1. Comece pelo diretório atual. Se na pasta onde está o main.go houver um go.mod — ótimo, trabalhamos.
\n
2. Se não houver — suba um nível (para a pasta pai). Verifique novamente.
\n
3. Repita o passo 2 até chegar à raiz do sistema de arquivos (/ no Linux/Mac ou C:\\ no Windows).
\n
4. Se chegar à raiz e não encontrar o go.mod — exiba o erro "go.mod file not found in current directory or any parent directory".
\n

Este algoritmo é chamado de "walk up the directory tree". Ele permite que você execute código de qualquer subpasta dentro do projeto. Por exemplo, se seu projeto está em /home/user/myapp/ e você entra em /home/user/myapp/cmd/ e executa go build, o Go encontrará o go.mod em /home/user/myapp/.

Exemplo prático: reproduzindo o erro

Vamos simular a situação. Crie um arquivo simples sem módulo:

// main.go\npackage main\n\nimport "fmt"\n\nfunc main() {\n    fmt.Println("Olá do mundo sem go.mod!")\n}

Agora, tente executar:

$ go run main.go\ngo: go.mod file not found in current directory or any parent directory; see 'go help modules'

Aí está, nosso erro. O Go percorreu honestamente todas as pastas da atual até a raiz, mas não encontrou o go.mod. A solução é óbvia: precisamos criar este arquivo.

Como corrigir o erro corretamente

Método 1: Início rápido com go mod init

A maneira mais correta é inicializar o módulo:

$ go mod init example.com/myfirstapp\ngo: creating new go.mod: module example.com/myfir