Go · Avançado · Português · Técnico
diretiva replace
Linha do go.mod que troca um módulo por outro caminho ou versão, como uma pasta local ou um fork, sem alterar os imports no código.
Onde usar
Usada para testar uma biblioteca local antes de publicar ou para aplicar um fork com correção. Vale só para o módulo principal; dependências não herdam seus replaces.
Em código
module meu/app
go 1.23
require github.com/x/lib v1.2.0
replace github.com/x/lib => ../libExemplos
Usei uma diretiva replace para apontar a dependência para a minha pasta.
O build quebrou no CI porque o replace apontava para um caminho local.
Cuidado
Não deixe replace com caminho local commitado: quem clona o projeto não tem aquela pasta e o build quebra.
Sinônimos
replace no go.mod