bash
make --trace testNotes
GNU make trace mode is very useful for dependency debugging.
Makefile Debugging, Parallelism & CI
Debug make behavior, inspect variables, run parallel builds safely, and build reliable CI targets.
Export
Copy the compact sheet, download it, or print it.
Download
`D` dense toggle · `C` copy all
Debugging commands
Inspect why make did or did not rebuild something.
bash
make --debug=aNotes
Noisy but invaluable for deep investigations.
makefile
$(info OBJ=$(OBJ))Notes
Simple and effective for generated lists.
Inspect origin and flavor together
See where a value came from and how it expands.
makefileANYdebugvariablesorigin
makefile
$(info CFLAGS origin=$(origin CFLAGS) flavor=$(flavor CFLAGS) value=$(value CFLAGS))Notes
Great for untangling overrides.
bash
make -rR --warn-undefined-variablesNotes
`-rR` disables built-in rules and variables in GNU make.
Parallel builds and CI patterns
Concurrency controls, reproducibility, and fail-fast targets.
Respect jobserver in recursive make
Propagate parallelism automatically using `$(MAKE)`.
makefileANYparallelrecursivejobserver
makefile
subdirs:
$(MAKE) -C api
$(MAKE) -C webNotes
Use `$(MAKE)` rather than plain `make` so flags like `-j` propagate correctly.
Synchronized parallel output
Keep log lines grouped by target when running with jobs.
bashANYparalleloutputci
bash
make -j8 --output-sync=targetNotes
Much easier to read in CI logs.
CI aggregate target
Create a single target for consistent pipeline execution.
makefileANYciaggregate
makefile
.PHONY: ci
ci: lint test buildNotes
A clean top-level target improves discoverability and consistency.
Local override include for CI-safe defaults
Load machine-specific settings without hardcoding them in shared files.
makefileANYciconfiginclude
makefile
-include .env.mkNotes
Combines well with CI-provided environment variables.
Reproducible dependency install target
Use lockfile-based install inside a phony or stamp target.
makefileANYcidependencies
makefile
.PHONY: deps
deps:
npm ciNotes
Replace with the appropriate package manager for your stack.
Defensive recipes
Safer shell behavior and clearer failures.
makefile
SHELL := /usr/bin/env bash
.SHELLFLAGS := -eu -o pipefail -cNotes
GNU make allows explicit shell configuration.
Use strict flags inside one-shell recipe
Fail fast in multi-line recipes.
makefileANYshelloneshelldefensive
makefile
.ONESHELL:
release:
set -euo pipefail
pnpm build
aws s3 sync dist/ s3://my-bucketNotes
Without `.ONESHELL`, shell flags reset on each line.
Guard required variables
Abort early when a required variable is missing.
makefileANYdefensivevalidation
makefile
ifndef VERSION
$(error VERSION is required. Usage: make release VERSION=1.2.3)
endifNotes
An easy way to make release flows safer.
More in Makefile
Makefile Recipes for Real Projects
Production-oriented Makefile targets for apps, Docker, Terraform, Python, Node, Go, and deployment workflows.
Makefile Portable POSIX Patterns
Portable makefile patterns that work across POSIX make environments, avoiding GNU-only features when needed.
Makefile Functions & Text Processing
GNU make text, path, conditional, shell, and metaprogramming functions with practical examples.
Makefile Pattern Rules & Dependency Generation
Pattern rules, wildcarding, implicit rules, static pattern rules, and generated dependency files in GNU make.
Makefile Cheat Sheet
Comprehensive GNU make and Makefile reference covering targets, prerequisites, recipes, variables, includes, conditionals, pattern rules, and command-line usage.