blog.dopana

返回

每个开发者都见过这种场景:一个 Makefile 里塞满了 test、lint、deploy、format 这些 target——没有一个是在构建东西。Make 是 1976 年为编译 C 代码设计的。把它当任务运行器用,就像用电子表格写文档。能用,但你在跟工具较劲。

just 就是为这个目的而生的现代命令运行器。

1. 核心问题:Make 不是任务运行器#

Make 的工作很简单:给定目标文件和源文件,如果源文件更新了就重新构建目标。就这么简单。整个设计围绕文件时间戳展开。

但开发者不需要基于文件的构建。他们需要的是:

  • make test —— 跑测试
  • make lint —— 检查代码风格
  • make deploy —— 部署到生产
  • make format —— 自动格式化代码

这些都不会生成文件。所以你得写 .PHONY 声明,用别扭的语法传变量,还有那些看不懂的 $@ 符号。Make 不是为这个设计的。

[!TIP] 如果你的 Makefile 里 .PHONY target 比真正的文件 target 还多,你就是在拿构建系统当任务运行器用。换 just 吧。

2. just 是什么?#

just 是 Casey Rodarmor(ripgrep 的作者)用 Rust 写的命令运行器。它把命令存在 justfile 里,按需执行。

把它想象成一个去掉了所有 Make 复杂特性的 Makefile:

  • 不追踪文件时间戳
  • 不需要 .PHONY
  • 不用争论 tab 还是 space
  • 变量语法不神秘

安装#

# 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 # 部署到生产(ENV=prod)
bash

不需要 .PHONY。不强制 tab。没有神秘语法。

3. 对比表#

特性GNU MakeJust
用途构建系统(基于文件)命令运行器
缩进必须 tab(用 space 会崩溃)space 或 tab
.PHONY非文件 target 必须声明不需要
参数make target VAR=valjust target val
列出命令grep hack 或 make -pnjust --list 内置
跨平台Unix 原生;Windows 需要 WSL单文件二进制,到处能跑
脚本语言只能 shellshell、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 的烦恼#

在 Make 里,如果有个叫 test 的文件夹,make test 会静默失败或执行错误的 target。你必须声明 .PHONY: test。Just 没这个问题——它执行的是命令,不是文件。

跨平台团队#

Just 在 Linux、macOS、Windows 上行为完全一致。不需要 WSL、Cygwin、路径问题。一个二进制文件,到处一样。

多语言脚本#

用 shebang 语法写任何语言的脚本:

justfile
# Python 脚本
validate:
    #!/usr/bin/env python3
    import json
    with open("config.json") as f:
        json.load(f)
    print("配置有效!")

# 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 声明
  • tab 换成 space(或者保留 tab——都能用)
  • $(VAR) 换成 {{VAR}}
  • 加个 default 脚本支持 just --list

7. 混合方案#

不必二选一。很多项目两个都用:

  • Makefile 负责真正的构建规则(编译、打包、生成资源)
  • justfile 负责开发任务(测试、lint、部署、格式化)

这样既利用了 Make 的长处,又保持了日常工作流的清爽。

justfile
# 构建用 make,其他用 just
build:
    make -C build/

test:
    cargo test

deploy:
    ./scripts/deploy.sh
just

参考资料#