一份 justfile 解决重复敲命令的问题just 语法与任务脚本完整实战指南【免费下载链接】just Just a command runner项目地址: https://gitcode.com/GitHub_Trending/ju/just每个团队都有一串被反复输入的命令跑测试、起服务、发部署。这些命令通常只存在于老员工的肌肉记忆和聊天记录里。而 justfile 就是用来终结这件事的——just 是一个轻量级命令运行器你把这些命令写进一个 justfile 文件之后一条just 任务名就能执行。那串每天要敲好几遍的构建命令周五下午新同事问了一句这个项目怎么跑测试来着。有人回了一句先装依赖再用 3.12 的 Python 起覆盖率注意别用系统默认解释器配了半屏的终端截图。这串命令团队里每个人都每天敲三五次。它的问题不在复杂度而在于约定没有落盘写在口口相传里的流程换个人、换个季度就会走样。把它固化成一个随仓库提交的文件是成本最低的改法。justfile 干的就是这件事而且不需要再学一套 shell 技巧。just把 Makefile 的繁琐留在身后如果你用过 Makefile可能会想起.PHONY、变量转义的坑、以及缩进必须是 Tab 这些经典烦恼。just 定位上是命令运行器而非构建系统它不关心依赖产物的时间戳只关心按顺序把命令跑对所以把这些历史包袱都甩掉了。这也是很多人把 just 当作 Makefile 替代方案的原因。几个直接感受得到的差别错误信息具体且带源码上下文语法错误会指出在哪一行未知任务名、循环依赖在运行前就会被静态检查出来不会跑到一半才崩任务可以接受命令行参数包括默认值和变长参数自带.env加载、跨平台支持Linux/macOS/Windows 无需额外依赖表达式语言丰富内置了几十个常用函数字符串、路径、日期、环境变量等。安装方面用cargo install just或者通过包管理器、官方发布的预编译二进制都行单文件无运行时依赖。装好之后大概是这样下面用一个小项目把它真正用起来。三步搭好第一份 justfile变量、食谱、参数与依赖一次到位假设项目叫invoice-cli一个 Python 写的开票工具日常操作就是四件事装环境、跑测试、本地起服务、发部署。我们边搭边看 justfile 语法是怎么长出来的。第 1 步把第一条命令收进 justfile在invoice-cli/下新建justfile先把测试收进去test: python3 -m pytest就这两行。test:定义了一个叫 test 的食谱recipe缩进的行是要执行的命令。just test运行它直接敲just不带参数则会列出所有食谱等于自带了一份任务菜单新人不用再问任何人。第 2 步用变量把会变的东西抽出来Python 版本和测试参数是会变的东西硬编码在命令里迟早要改。justfile 里变量用:定义PYTHON : python3.12 COV : --covinvoice LAST_TAG : git describe --tags --always test: {{PYTHON}} -m pytest {{COV}} bootstrap: {{PYTHON}} -m venv .venv . .venv/bin/activate pip install -e .[dev] build: echo building {{LAST_TAG}} ... pip install build python3 -m build三个值得注意的点反引号git describe --tags --always会在求值时执行命令并把输出作为变量值版本信息从此不用手写前缀让echo只输出内容、不回显命令本身终端更干净变量名用大写是社区里比较通行的写法后面排错时一眼能认出它是配置而不是任务。第 3 步给食谱加参数和依赖本地起服务偶尔要换端口部署前必须先测试再构建。参数和依赖分别解决这两件事run port8000: {{PYTHON}} -m uvicorn invoice.app:app --port {{port}} check *paths: ruff check invoice/ {{paths}} mypy invoice deploy: test build ./scripts/deploy.shrun的参数port有默认值8000不带参数直接just run也可以just run 9000覆盖check里的*paths是变长参数just check app/main.py会把文件透传给ruffdeploy声明了test和build为依赖just deploy会先按顺序跑完它们。如果任务名写错或依赖成环just 在执行前就会报错不会白跑半天。不确定某个任务展开成什么命令时just --show deploy会原样打印不用真的执行。到这里一个够日常用的 justfile 就成型了just # 列出所有任务 just bootstrap # 新机器一键初始化 just check . # 检查全部代码 just run 9000 # 换个端口起服务 just deploy # 测试、构建、部署一步到位让任务随场景变化条件执行与跨平台 shell任务写死一次很容易难的是换个环境就不对了。这一节按场景分组讲动态能力。同一任务、不同参数用默认参数覆盖即可比如给run再加一个环境参数run port8000 envdev: APP_ENV{{env}} {{PYTHON}} -m uvicorn invoice.app:app --port {{port}}同一任务、不同系统路径和解释器位置在 Windows 和 Unix 上不同用if表达式在变量层解决而不是复制两份任务。/是路径拼接操作符venv_bin : if os() windows { .venv/Scripts } else { .venv/bin } PY : venv_bin / python仓库里的 examples/cross-platform.just 就是一个完整的跨平台 Python 项目示例思路一致。shell 本身的行为差异set语句可以为不同平台指定 shell。这样 Windows 上跑的是 PowerShell其他平台跑的是 bash且开启严格模式出错时不会吞掉错误继续往下set shell : [bash, -euo, pipefail] set windows-shell : [powershell.exe, -NoLogo, -Command]一个食谱其实是一段脚本如果任务体超过三四行与其在缩进里堆 shell 转义不如用 shebang 把食谱写成独立脚本just 会处理临时文件的事backup: #!/usr/bin/env bash set -euo pipefail stamp$(date %F) cp data/invoices.db backup/invoices-{{stamp}}.db团队里的 justfile模块化、别名与 .env 集成单人项目一个 justfile 够用了团队项目要考虑三件事别太长、别输错、别泄密。别名长任务名配肌肉记忆加一行alias即可alias t : test alias b : build之后just t等价于just testjust alias可以随时列出所有别名。模块化任务多了以后按域拆分。mod语句会把同目录的ci.just、deploy.just或子目录ci/justfile挂载进来任务用模块::任务的地址调用mod ci mod deployjust ci::lint just deploy::staging如果只是想在多个文件间共享变量用import common.just更轻。模块还能用?标记为可选文件不存在时不会报错——这对可选的发布流程这类场景很合适。.env 集成密钥和部署地址不该写进 justfile交给.env文件set dotenv-load set dotenv-filename : [.env.local, .env] export APP_ENV : stagingdotenv-load开启后just 会沿目录向上查找并加载.env任务里通过{{S3_BUCKET}}或直接$S3_BUCKET使用dotenv-filename接受列表优先匹配.env.local个人环境加入 .gitignore找不到再回退到团队共用的.envexport声明的变量会注入所有子命令的环境任务里不用重复传参。任务跑不对先查这张速查表justfile 出问题时九成是变量值不符合预期或参数没传对。这几个开关按顺序用一遍基本都能定位命令用途just列出所有任务确认任务名没拼错just --summary一行一个任务参数和依赖一目了然just --show deploy打印展开后的最终命令不执行just --dry-run deploy显示完整执行计划含依赖顺序不真正运行just --explain deploy边执行边打印任务注释和每条命令just --evaluate输出所有变量的求值结果just --evaluate LAST_TAG可只查一个just --verbose/--quiet增加 / 减少输出量另外记住两点未知任务名、循环依赖这类错误是静态检查的运行前就会报报错信息直接指向行号和上下文照着改就行怀疑环境问题时先--evaluate看变量再--show看命令顺序别反。让 justfile 活得久一点命名、顺序与反模式justfile 和任何代码一样会腐化几条低成本约定能省很多事命名任务名全小写、连字符分隔build-docs下划线开头表示私有_helper不会出现在列表里供其他任务内部调用变量名大写。顺序set设置放最前其次变量、别名最后是任务高频任务靠前放列表打开第一眼就是最常用的。常见反模式单个任务超过十几行——要么拆小要么转成 shebang 脚本硬编码绝对路径——用变量和内置函数如justfile_directory()表达一个任务塞进构建、部署、通知三件事——拆成可组合的小任务用依赖串起来把密钥写进 justfile——一律进.env打开dotenv-load。从一份 justfile 开始just 的价值一句话把只存在于老员工脑子里的命令变成提交在仓库里的任务脚本。想继续深入仓库里这些资料都是第一手的完整文档在 book/中文说明见 README.中文.md更多真实写法看 examples/语法细节可查 GRAMMAR.md 和解析器源码 src/parser.rs。今天就可以动手挑出你敲得最勤的那条命令把它写成第一个食谱。【免费下载链接】just Just a command runner项目地址: https://gitcode.com/GitHub_Trending/ju/just创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考