如何安裝 just 命令執行器：撰寫 justfile、執行 recipe 與 make 對比

安裝 just，寫 justfile 跑 recipe，並知道何時優於 Makefile。

儲存庫里总有「先 lint 再 test 再 build」这类重复命令，写在 README 里没人看，塞进 package.json 的 scripts 又和语言绑定。just 是 Casey Rodarmor 写的命令執行器：在项目根放一个 justfile，用 just 跑具名 recipe，语法比 Make 友好、跨平台也更省心。本教學涵蓋 macOS/Linux 安裝 just、撰寫 justfile、執行 recipe，以及與 make 的對照，面向 hereink 讀者常用的多儲存庫終端工作流。

檢索詞是如何安裝 just 命令執行器並寫 justfile 執行 recipe 對比 make。讀完應能安裝 just、写第一条 recipe、用 just --list 查看任务，并理解何时用 just 替代 Makefile。

just 解决什么问题

上游：github.com/casey/just，文档 just.systems。安裝后執行 just --version 确认。

安裝 just

1. 1
   macOS（Homebrew）

   brew install just。验证：which just 与 just --version。

2. 2
   Linux（发行版包）

   Arch：sudo pacman -S just。Debian/Ubuntu 若儲存庫较旧，可用 cargo install just 或官方预编译包（见 just.systems 安裝页）。

3. 3
   Rust 工具链

   已装 Rust：cargo install just。确保 ~/.cargo/bin 在 PATH 里。

4. 4
   版本管理器

   mise use -g just@latest 或 asdf plugin add just（若团队已用 asdf/mise）。

撰寫 justfile

在项目根创建 justfile（或 .justfile）。最小示例：

# 默认 recipe：只输入 just 时執行
default:
    just --list

# 带注释，会出现在 just --list
# 跑单元测试
test:
    cargo test

# 依赖其他 recipe
check: lint test
    echo "all green"

lint:
    cargo clippy -- -D warnings

常用语法要点：

• recipe 名：name: 下一行起缩进命令（空格，不是 tab）。
• 参数：deploy env: 然后命令里用 {{env}}。
• 变量：文件顶部 port := "3000"，recipe 内 {{port}}。
• shebang recipe：以 #!/usr/bin/env bash 开头可写多行 shell。

port := "8080"

# 启动本地服务
serve:
    python -m http.server {{port}}

# 带默认值的可选参数
greet name="world":
    echo "hello {{name}}"

執行 recipe

cd ~/projects/my-app
just --list          # 列出 recipe
just test            # 執行 test recipe
just check           # 先 lint 再 test（依赖顺序）
just greet Alice     # 传参
just                 # 若定义了 default recipe

just 会在包含 justfile 的目录（或父目录）查找文件；也可用 just --justfile path/to/justfile recipe。加 -n / --dry-run 只打印将要执行的命令，不真正執行。

与 make 对照

適合 just

统一 test / lint / dev 入口；多语言儲存庫不想绑 npm scripts；想要比 Make 更可读的 task 列表。

仍用 make

C/C++ 增量编译、复杂依赖图、已有成熟 Makefile 且团队熟悉。