make como executor de tarefas: alvos phony, tabulações e um shell por linha

O que é

O make reconstrói um alvo (target) a partir de seus pré-requisitos, executando uma receita (recipe) quando o alvo não existe ou é mais antigo do que aquilo de que depende. Usado como executor de tarefas, a maioria dos alvos não são arquivos, e sim nomes de comandos: make test, make lint, make deploy. O manual do GNU make chama esses alvos de phony targets e recomenda declará-los como pré-requisitos do alvo especial .PHONY, para que a receita rode mesmo que exista um arquivo com esse nome. Duas regras de sintaxe documentadas causam a maioria dos erros de quem está começando: cada linha de receita deve começar com uma tabulação (a menos que .RECIPEPREFIX seja alterado), e cada linha de receita é executada em um novo subshell. Assim, um cd ou uma variável de shell em uma linha não afeta a seguinte, a não ser que as linhas sejam unidas em uma só linha lógica com && e barras invertidas, ou que o alvo especial .ONESHELL seja declarado.

Por que importa

Um Makefile oferece a quem chega ao projeto, inclusive a agentes, um único lugar onde se descobrem os comandos do projeto, dispensa qualquer executor específico de linguagem e consegue expressar dependências reais (gerar código antes de compilar), o que uma lista simples de scripts não faz. Entender mal as duas regras acima leva a erros "missing separator" e a receitas que rodam em silêncio no diretório errado.

Como aplicar

• Torne o alvo padrão inofensivo: segundo o manual, o primeiro alvo é o objetivo padrão (default goal), a menos que .DEFAULT_GOAL esteja definido; portanto, coloque help em primeiro lugar ou defina .DEFAULT_GOAL := help.
• Declare todos os alvos de comando em uma única linha .PHONY: perto do início do arquivo.
• Una os passos de shell que dependem uns dos outros: cd build && cmake .. && $(MAKE); o exemplo do manual usa && para que um cd com falha interrompa a linha. Use $(MAKE) para recursão.
• Ofereça valores padrão que possam ser sobrescritos: PYTHON ?= python3, chamado como make test PYTHON=python3.12.
• Mantenha os alvos de arquivo reais, com seus pré-requisitos, para que o trabalho inalterado seja ignorado; mantenha os alvos phony como phony, para que sempre sejam executados.
• Use make -n para imprimir as receitas sem executá-las e make -j para alvos independentes.

Armadilhas

Espaços no lugar de uma tabulação. Em uma receita, o make expande $VAR como $V seguido de AR; escreva $$VAR para a variável de shell. Um alvo phony com o mesmo nome de um diretório existente, que não foi declarado em .PHONY, é considerado "up to date" (atualizado) e nunca roda. Linhas silenciadas com @ escondem o comando que falhou. Receitas que dependem de recursos do bash rodam sob /bin/sh, a menos que SHELL := bash esteja definido. Execuções em paralelo expõem dependências ausentes entre alvos que funcionavam apenas por acaso quando executados em sequência.