Makefile как единая точка входа в проект

· 2 мин чтения · инструменты

Во всех моих проектах в корне лежит Makefile. Не потому, что я собираю C, а потому, что так не нужно вспоминать, как в этом проекте запускаются тесты, линтер или локальная база.

Минимальный шаблон

.PHONY: help run test lint fmt db
.DEFAULT_GOAL := help

APP  := api
PORT ?= 8080

help: ## показать список команд
	@grep -E '^[a-zA-Z_-]+:.*?## ' $(MAKEFILE_LIST) | \
		awk 'BEGIN {FS = ":.*?## "}; {printf "  %-8s %s\n", $$1, $$2}'

run: ## запустить сервис локально
	PORT=$(PORT) go run ./cmd/$(APP)

test: ## тесты с race-детектором
	go test -race ./...

lint: ## статический анализ
	golangci-lint run

fmt: ## форматирование
	gofmt -w .

db: ## поднять локальную базу
	docker compose up -d db

Команда make без аргументов показывает справку, собранную из комментариев после ##:

$ make
  help     показать список команд
  run      запустить сервис локально
  test     тесты с race-детектором
  ...

Пара правил

Почему не justfile

just мне нравится, но make уже установлен везде, включая CI-образы и серверы. Для пяти-десяти команд его возможностей хватает с запасом.