1. O que é e para que serve

A biblioteca cron para Go (repositório github.com/robfig/cron/v3) é um agendador de tarefas poderoso e flexível, escrito em Go puro. Ela oferece aos desenvolvedores uma maneira simples e expressiva de executar funções (tarefas) em horários programados, usando a sintaxe padrão de expressões cron (como em sistemas Unix). Para que serve? No desenvolvimento moderno de aplicações server-side, microsserviços e utilitários de linha de comando, surge frequentemente a necessidade de executar ações repetitivas: limpar cache, enviar e-mails em massa, criar backups, sincronizar dados com APIs externas, coletar métricas e muito mais. Em vez de escrever loops complexos com time.Sleep() ou depender de daemons cron externos (que nem sempre estão disponíveis em ambientes conteinerizados como Docker ou Kubernetes), a biblioteca cron permite incorporar o agendador diretamente na sua aplicação Go.

A principal vantagem do cron sobre alternativas (como time.Ticker) é o suporte a agendamentos complexos. Você pode definir uma tarefa para ser executada "às 3:15 da manhã toda terça-feira" ou "a cada 5 minutos, das 9 às 17 horas, em dias úteis" com uma única linha. A biblioteca também suporta extensões adicionais, como segundos (o cron padrão não suporta), agendamentos nomeados (@every 5s, @daily, @weekly) e parada segura do agendador via contexto. A versão v3, que é a estável atual, foi completamente reformulada para segurança em concorrência e tratamento correto de panics nas tarefas, tornando-a a escolha ideal para sistemas em produção.

No PythonLib, buscamos fornecer os melhores guias sobre ferramentas modernas. Este artigo é um guia completo sobre a biblioteca cron para Go. Você aprenderá como instalá-la, como criar e gerenciar tarefas, como tratar erros e como construir sistemas confiáveis com processos em segundo plano. Vamos abordar todos os métodos principais, trazer exemplos reais de código e dar dicas de desempenho.

2. Instalação

A instalação da biblioteca cron para Go é feita da forma padrão através do gerenciador de pacotes Go (go modules). Certifique-se de ter o Go versão 1.16 ou superior instalado (recomendado 1.21+). Execute o seguinte comando na raiz do seu projeto (onde está o arquivo go.mod):

go get github.com/robfig/cron/v3@latest

Este comando baixará a biblioteca e a adicionará aos seus arquivos go.mod e go.sum. Depois disso, você pode importá-la no seu código:

import "github.com/robfig/cron/v3"

Se você estiver usando uma versão antiga do Go (1.15 ou inferior) ou quiser instalar uma versão específica (por exemplo, v3.0.1), especifique-a explicitamente:

go get github.com/robfig/cron/v3@v3.0.1

Importante: A biblioteca não possui dependências externas, além da biblioteca padrão do Go. Isso a torna leve e segura para incluir em qualquer projeto.

3. Início rápido — exemplo mínimo funcional

Vamos criar um agendador simples que imprime "Olá, Mundo!" a cada minuto. Este exemplo demonstra os conceitos básicos: criação do agendador, adição de uma tarefa e sua execução.

package main

import (
    "fmt"
    "time"

    "github.com/robfig/cron/v3"
)

func