> For the complete documentation index, see [llms.txt](https://alexrios.gitbook.io/gomodules/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alexrios.gitbook.io/gomodules/basico/rotina-usando-modulos.md).

# Rotina usando módulos

Seu fluxo de trabalho para um dia típico:

* Adicione os imports nos seus arquivo `.go` conforme necessidade.
* Os comandos `go build` ou `go test` **baixarão** as novas dependências necessárias

{% hint style="warning" %}
**Mudança importante desde Go 1.16**: Comandos de build como `go build`, `go test` e `go run` **não modificam mais automaticamente** o arquivo `go.mod`. Para adicionar ou atualizar dependências, use `go get` ou `go mod tidy`.
{% endhint %}

Haverá momentos onde será necessário escolher versões especificas da dependência. Em casos como esses deve ser usado o comando `go get` ou `go mod tidy`.

O formato do comando go get é `<nome-do-modulo>@<versão>`

```bash
# Adicionar ou atualizar uma dependência específica
$ go get foo@v1.2.3

# Adicionar a versão mais recente
$ go get foo@latest

# Adicionar uma versão específica de branch
$ go get foo@master

# Remover uma dependência (Go 1.17+)
$ go get foo@none
```

**Comandos úteis para gerenciar dependências:**

```bash
# Adicionar dependências faltantes e remover não utilizadas
$ go mod tidy

# Atualizar uma dependência para a versão mais recente
$ go get -u foo

# Atualizar todas as dependências diretas
$ go get -u ./...

# Verificar atualizações disponíveis
$ go list -u -m all
```

{% hint style="warning" %}
Também é possível alterar o arquivo `go.mod` diretamente, caso necessário. Em todo caso, de preferência para que os comandos `go` façam as alterações no arquivo.
{% endhint %}