blog.dopana

戻る

すべての開発者はこの光景を見たことがある:test、lint、deploy、formatなどのターゲットが詰まったMakefile。どれもビルドしない。Makeは1976年にCコードをコンパイルするために設計された。タスクランナーとして使うのは、スプレッドシードで文書を作成するようなもの。可能だが、ツールと格闘することになる。

justはこの目的のために作られたモダンなコマンドランナー。

1. 根本的な問題:Makeはタスクランナーではない#

Makeの仕事はシンプル:ターゲットファイルとソースファイルを与え、ソースが新しい場合はターゲットをリビルドする。それだけ。設計はファイルタイムスタンプに基づいている。

しかし開発者が必要なのはファイルベースのビルドではない。必要するのは:

  • make test — テスト実行
  • make lint — コードスタイルチェック
  • make deploy — 本番にデプロイ
  • make format — コード自動フォーマット

どれもファイルを生成しない。そのため.PHONY宣言、変数渡しの複雑な構文、$@のような謎の記号が必要になる。MakeはこのPurposeで設計されていない。

[!TIP] Makefileに.PHONYターゲットが通常のファイルターゲットより多い場合、ビルドシステムをタスクランナーとして使っている。justに切り替えよう。

2. justとは?#

justはCasey Rodarmor(ripgrepの作者)がRustで作ったコマンドランナー。justfileにコマンドを保存し、必要時に実行する。

Makeを複雑にする要素をすべて取り除いたMakefileと考えればいい:

  • ファイルタイムスタンプの追跡なし
  • .PHONY宣言なし
  • タブvsスペースの聖戦なし
  • 謎の変数構文なし

インストール#

# macOS
brew install just

# Ubuntu/Debian
sudo apt install just

# Cargo(任意のプラットフォーム)
cargo install just

# Windows
winget install just
bash

最小限のJustfile#

コマンド実行:

just test # テスト実行
just lint # リント
just deploy prod # prodにデプロイ(ENV=prod)
bash

.PHONYなし。タブ必須なし。謎の構文なし。

3. 比較表#

機能GNU MakeJust
目的ビルドシステム(ファイルベース)コマンドランナー
インデントタブ必須(スペース=クラッシュ)スペースまたはタブ
.PHONYファイル以外のターゲットに必要不要
引数make target VAR=valjust target val
コマンド一覧grepハックまたはmake -pnjust --list内蔵
クロスプラットフォームUnix ネイティブ;WindowsはWSL必要シングルバイナリ、どこでも動作
レシピ言語シェルのみシェル、Python、Nodeなど
エラーメッセージ謎明確で具体的
.envサポートなし内蔵
パラメータデフォルト複雑初等関数:ENV="dev"

4. Makeを使うべきケース#

Makeが勝るのは特定のシナリオ:

インクリメンタルビルド#

C/C++コードをコンパイルする場合、Makeのファイルタイムスタンプ追跡が最適。変更されたものだけリビルド。

Makefile
main: main.c utils.c
	gcc -o main main.c utils.c
makefile

依存関係ゼロの環境#

MakeはほぼすべてのUnixシステムに同梱されている。レガシーサーバー、CI/CDパイプライン、コントリビューターのインストールを制御できないオープンソースプロジェクトのスクリプトにはMakeが安全。

既存のエコシステム#

Linuxカーネル、autotools、CMake、そして無数のプロジェクトがMakefileを使っている。これらのプロジェクトにコントリビュートするなら、Makeを使うことになる。

5. Justを使うべきケース#

Justは日次開発ワークフローで輝く:

ショートカット#

よく使うコマンドを一箇所に保存。新しいチームメンバーはjust --listを実行して利用可能なすべてを確認。

.PHONYの headachesなし#

Makeでは、testという名前のフォルダが存在する場合、make testはサイレントに失敗したり間違ったターゲットを実行する。.PHONY: testを宣言する必要がある。Justにはこの問題がない。コマンドを実行するだけ。

クロスプラットフォームチーム#

JustはLinux、macOS、Windowsでまったく同じ動作。WSL不要、Cygwin不要、パスの問題なし。一つのバイナリ、どこでも同じ動作。

ポリグロットレシピ#

ヒアドキュメント構文でどの言語でもレシピを書ける:

justfile
# Python レシピ
validate:
    #!/usr/bin/env python3
    import json
    with open("config.json") as f:
        json.load(f)
    print("Config有効!")

# Node.js レシピ
report:
    #!/usr/bin/env node
    const fs = require("fs");
    const pkg = JSON.parse(fs.readFileSync("package.json"));
    console.log(`Project: ${pkg.name} v${pkg.version}`);
just

初等パラメータ#

デフォルト値付きで引数を渡せる:

justfile
# マイグレーション実行
migrate ENV="dev" STEPS="1":
    ./manage.py migrate --environment={{ENV}} --steps={{STEPS}}

# リソース作成
resource NAME TYPE="service":
    ./scripts/create-resource.sh {{NAME}} {{TYPE}}
just

Makeのmake migrate ENV=dev STEPS=1と比較。

6. 移行ガイド#

Makefileからjustfileへの移行は簡単:

前(Makefile)#

Makefile
.PHONY: test lint format deploy

test:
	npm test

lint:
	npm run lint

format:
	npx prettier --write .

deploy:
	./scripts/deploy.sh
makefile

後(justfile)#

justfile
test:
    npm test

lint:
    npm run lint

format:
    npx prettier --write .

deploy:
    ./scripts/deploy.sh
just

主な変更:

  • .PHONY宣言を削除
  • タブをスペースに置換(またはタブを維持 — 両方動作)
  • $(VAR)を{{VAR}}に置換
  • just --list用のdefaultレシピを追加

7. ハイブリッドアプローチ#

排他的に選択する必要はない。多くのプロジェクトで両方を使う:

  • Makefile — 実際のビルドルール(コンパイル、バンドル、アセット生成)
  • justfile — 開発タスク(テスト、リント、デプロイ、フォーマット)

これによりMakeの強みを活かしつつ、日次ワークフローをクリーンに保てる。

justfile
# ビルドにはmake、その他はjust
build:
    make -C build/

test:
    cargo test

deploy:
    ./scripts/deploy.sh
just

参照#