make como ejecutor de tareas: targets ficticios, tabuladores y un shell por línea

Qué es

make reconstruye un target a partir de sus prerrequisitos ejecutando una receta cuando el target no existe o es más antiguo que aquello de lo que depende. Usado como ejecutor de tareas, la mayoría de los targets no son archivos sino nombres de comandos: make test, make lint, make deploy. El manual de GNU make los llama targets ficticios (phony) y dice que deben declararse como prerrequisitos del target especial .PHONY, para que la receta se ejecute aunque exista un archivo con ese nombre. Dos reglas de sintaxis documentadas causan la mayoría de los errores de quien empieza: cada línea de receta debe comenzar con un tabulador (a menos que se cambie .RECIPEPREFIX), y cada línea de receta se ejecuta en un nuevo subshell, de modo que un cd o una variable de shell en una línea no afecta a la siguiente, a menos que las líneas se unan en una sola línea lógica con && y barras invertidas, o se declare el target especial .ONESHELL.

Por qué importa

Un Makefile ofrece a quienes se incorporan y a los agentes un único lugar localizable para los comandos de un proyecto, no necesita un ejecutor específico de ningún lenguaje, y puede expresar dependencias genuinas (generar código antes de compilar) que una lista plana de scripts no puede. Interpretar mal las dos reglas anteriores produce errores de «missing separator» y recetas que se ejecutan silenciosamente en el directorio equivocado.

Cómo aplicarlo

• Hacer inofensivo el objetivo por defecto: el manual establece que el primer target es el objetivo por defecto a menos que se fije .DEFAULT_GOAL, así que conviene poner help primero o establecer .DEFAULT_GOAL := help.
• Declarar todos los targets de comando en una sola línea .PHONY: cerca del principio.
• Unir los pasos de shell dependientes: cd build && cmake .. && $(MAKE); el ejemplo del manual usa && para que un cd fallido detenga la línea. Usar $(MAKE) para la recursión.
• Ofrecer valores por defecto reemplazables: PYTHON ?= python3, invocado como make test PYTHON=python3.12.
• Mantener reales los targets de archivo reales, con sus prerrequisitos, para que el trabajo sin cambios se omita; mantener ficticios los targets ficticios para que siempre se ejecuten.
• Usar make -n para imprimir las recetas sin ejecutarlas y make -j para los targets independientes.

Trampas

Espacios en lugar de un tabulador. $VAR en una receta lo expande make como $V seguido de AR; hay que escribir $$VAR para la variable de shell. Un target ficticio con el mismo nombre que un directorio existente que no se declaró .PHONY está «actualizado» y nunca se ejecuta. Las líneas silenciadas con @ ocultan el comando que falla. Las recetas que dependen de funciones de bash se ejecutan bajo /bin/sh a menos que se establezca SHELL := bash. Las ejecuciones en paralelo exponen dependencias faltantes entre targets que por casualidad funcionaban en secuencia.