Just项目：解决Recipe缩进错误的正确姿势

Just是一个现代化的命令行工具，类似于Make，但更简单易用。它使用justfile来定义任务（recipes），帮助开发者自动化常见的开发工作流程。在使用Just时，一个常见的错误就是recipe缩进格式不正确。

问题现象

当用户尝试运行一个简单的justfile时，可能会遇到类似以下的错误信息：

error: Unknown start of token:
 ——▶ justfile:2:6
  │
2 │ just --list
  │      ^

这个错误表明Just解析器在第二行第六列遇到了意外的字符。错误的核心在于recipe的格式不符合Just的语法要求。

根本原因

Just对justfile的格式有严格要求：

1. 每个recipe（任务）必须由名称和冒号组成首行
2. recipe的主体（即要执行的命令）必须缩进（通常使用两个或四个空格）
3. 缩进必须一致，不能混用制表符和空格

在错误示例中，用户直接在recipe名称后跟命令而没有缩进，这违反了Just的语法规则。

正确写法

正确的justfile应该如下所示：

default:
  just --list
  
hello:
  echo "hello world"

deploy:
  nixos-rebuild switch --flake . --use-remote-sudo

debug:
  nixos-rebuild switch --flake . --use-remote-sudo --show-trace --verbose

up:
  nix flake update

最佳实践

1. 统一缩进风格：建议使用两个空格作为缩进标准，避免使用制表符
2. 保持一致性：整个justfile中保持相同的缩进风格
3. 注释使用：可以使用#添加注释，提高可读性
4. 多行命令：对于长命令，可以使用反斜杠\进行换行

进阶提示

Just还支持许多强大功能：

• 参数传递
• 环境变量
• 依赖关系
• 条件执行
• 静默执行

掌握正确的缩进格式是使用Just的基础，之后可以逐步探索这些高级功能来构建更复杂的自动化工作流。

通过遵循这些简单的格式规则，开发者可以避免常见的语法错误，充分发挥Just在项目自动化中的潜力。