Makefile как единая точка входа в проект
Во всех моих проектах в корне лежит 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-детектором
...
Пара правил
- Все цели — в
.PHONY: файлов с такими именами нет, и make не должен их искать. - Переменные через
?=, чтобы их можно было задать из окружения:PORT=9000 make run. - Отступы в рецептах — только табами. Редактор, который молча заменяет их пробелами, приводит к классической ошибке
missing separator. make -n цельпоказывает команды, не выполняя их. Полезно перед чем-то разрушительным.
Почему не justfile
just мне нравится, но make уже установлен везде, включая CI-образы и серверы. Для пяти-десяти команд его возможностей хватает с запасом.