为啥要把终端命令变成代码？

说实话，我以前总是手敲一堆命令。

一会儿git pull，一会儿npm run dev，搞得手指dou快抽筋。

结果呢？项目文档里全是“打开终端，跑这些”。

害，那种感觉像是把说明书藏在抽屉里谁也不想翻。

咱就是说要是Neng把这些命令写进代码里一键就Neng搞定，那该多爽啊。

这不就有了just——一个把命令当配方的工具。

just受老牌编排工具make的启发，只管管理项目专属的命令集合。

它不需要额外依赖，跨平台——Linux、Mac、WindowsdouNeng跑。

Zui关键的是它让“运行命令”kan起来像“调用函数”。

一句just run，等于把一长串Django manage.py …或flutter build …全部打包进去了。

# 安装脚本示例

curl -fsSL https://example.com/install.sh | sudo bash -s -- --to /usr/local/bin
# 上面那行其实是官方提供的简易安装方式，你也Ke以直接下载二进制文件放到 PATH 下
just --help   # kankan帮助信息，确认装好啦

# 小提示：Ru果你用的是 Windows，Ke以通过包管理器 Scoop 安装 just。

# 在项目根目录新建一个叫 justfile 的文件：

@run:
    echo "启动项目啦"
    python manage.py runserver
@test:
    echo "跑测试"
    pytest tests/
@build:
    echo "构建产物"
    flutter build apk --release

# 保存后在终端里敲：

just run   # 项目直接起飞
just test  # 测试一键搞定
just build # 打包也不再手忙脚乱

# kan，这不就是把命令写进代码里了吗？哈哈，一点点操作量就省下来了。

@run:
    just _echo_url
    cd "{{justfile_directory}}"
    {{python_interpreter}} manage.py runserver
@_echo_url:
    echo "前端地址：http://localhost:8000"
    echo "后台地址：http://localhost:8000/admin/"
@test app="myapp":
    export CONFIG_FILE={{app}}/fixtures/config.yaml
    uv run manage.py test {{app}}
@watch_and_run:
    just _echo_url
    cd "{{justfile_directory}}"
    {{python_interpreter}} manage.py tailwind runserver

# 这里用了变量和子配方，让常用信息统一输出，省得每次手动复制粘贴。

root := justfile_directory
app_version := `grep '^version:' pubspec.yaml | cut -d ' ' -f2 | cut -d '+' -f1`
app_build   := `grep '^version:' pubspec.yaml | cut -d ' ' -f2 | cut -d '+' -f2`
@run:
    flutter run \
        --dart-define=APP_VERSION={{app_version}} \
        --dart-define=APP_BUILD_NUMBER={{app_build}}
@build in_dev="false":
    flutter build apk \
        --release \
        --obfuscate \
        --split-debug-info=build/debug-info \
        --dart-define=APP_VERSION={{app_version}} \
        --dart-define=APP_BUILD_NUMBER={{app_build}}
@test *args:
    flutter test "$@" || true

# 用 just 把繁琐的编译参数一次性塞进去，以后只要改版本号就改变量，省事儿！你懂的。

# **统一入口**——所有项目特有的脚本，dou集中在一个文件里不再四处搜索 Bash 脚本或 npm script。

# **可读性**——配方名字像函数名，业务同事一眼就懂干啥。比如@deploy_staging, @lint_fix.

# **可维护**——修改一次配方，全团队受益。再也不用担心某个人改了某个 Makefile 却忘记提交。

# **安全性**——Ke以给配方加前置检查，比如确保虚拟环境Yi激活、数据库Yi启动之类的。这样出错率大幅下降。

# 场景：每天早上启动 Django 开发服务器并打开浏览器窗口。

No Just：

  1️⃣ 打开终端

  2️⃣ 输入 .venv/bin/python manage.py runserver &

  3️⃣ 手动复制 URL 到浏览器

You Just：

  $ just dev_start

# 用时对比：手敲大概需要 15 秒左右，而 just 一键只要 3 秒。累计下来一个月省下近半小时！哈哈，这算哪门子效率提升呀！不对不对，是几小时啦！你懂的～

# 在 CI 环境里你只需要写几行脚本：

#!/usr/bin/env bash
set -e
# 拉取依赖、运行测试、构建镜像全交给 just 管理
just install_deps
just test_all
just docker_build
just docker_push

# 这样 CI 配置文件保持极简，而真正的业务逻辑全部埋在项目内部的 justfile 中。维护成本大幅降低，团队成员只要kan README 就Neng快速上手。

# 那天晚上，我准备跑单元测试，却忘记先启动 Postgres 容器。

# 本来得去 Terminal 手动执行 ​//……​//… ，结果踩坑报错无数次。

"

 @test_all : 
     just start_db 
     pytest tests/ 
 @start_db : 
     docker start pg_container 
     sleep 5 
 

从此以后我再也不用担心忘记前置步骤了。真是省心又省事~ 哈哈 。

咱们常说「代码即文档」，现在Ke以 到「命令即代码」。

把每一步操作dou写进 Just 配方，就相当于给团队提供了一份活文档。

当新人加入，只需要阅读一下 .Justfile，就Neng知道整个项目怎么跑、怎么测、怎么部署。 不对不对，还Ke以直接在 VSCode 的任务面板里绑定快捷键，一键完成所有工作流。你懂的～

- 想在配方里使用环境变量？直接写 {{ENV_VAR}} ，Just 会自动替换。