just
通过项目内 justfile 定义和运行常用命令的任务执行器,支持配方依赖、参数、环境变量和多种脚本解释器。
just 的用途与边界
just 是项目级命令执行器,通过 justfile 为编译、测试、格式化、生成和部署等既有命令提供统一入口。它支持配方依赖、参数、环境变量、模块与多种脚本解释器,但不追踪输入输出文件,也不替代具备增量构建能力的构建系统。
Windows shell 必须明确
配方中的引号、变量、管道和路径由 shell 解释。Windows 用户可以使用 Git for Windows 等提供的 sh,也可以显式选择 PowerShell 或 cmd。团队项目应在 justfile 中固定预期 shell,并在持续集成环境验证,避免只在作者电脑上工作。
运行第三方配方等同于执行代码
justfile 可以调用任意命令、脚本和其他配方,并以当前用户权限运行。陌生仓库中的清理、安装和部署任务可能改写文件、访问环境变量或发起网络请求。执行前应审查完整依赖链,在低权限测试环境运行,并确保版本控制和备份可恢复。
维护记录
本页于 2026-08-06 根据 just 的命令执行器定位、配方依赖、Windows shell、向上查找 justfile 和 dotenv 风险复核。归档文件为 1.57.0 Windows x64 MSVC 压缩包。
保存到自己的网盘
打开网盘后可直接获取,也可以先保存到自己的网盘,方便换设备继续使用。
夸克网盘(无需提取码)
推荐将「just」保存到该网盘
百度网盘
将「just」保存到该网盘
just Windows 项目任务配置教程
just 通过 justfile 保存重复命令。先在空测试目录编写只输出文本的配方,确认 Windows shell 行为,再接入构建、测试或部署流程。
安装前准备
- 明确团队使用 PowerShell、cmd 还是 sh;默认 shell 不一致会影响引号、变量、管道和路径。
- 在版本控制项目中创建测试分支,确保运行配方前后可以查看文件和配置差异。
- 检查项目是否使用 .env,并避免让密钥出现在配方输出、进程参数或日志中。
安装步骤
- 01
解压 just 程序
将 Windows x64 压缩包解压到固定目录,核对版本后通过完整路径运行帮助或版本命令。
- 02
配置 PATH 与 shell
将程序目录加入用户 PATH,并根据团队环境明确 justfile 使用的 Windows shell,不要依赖个人机器的隐含默认值。
- 03
创建最小 justfile
在空目录中新建 justfile,只加入输出固定文本的配方,先验证文件发现、缩进和 shell 调用均符合预期。
快速上手
- 01
列出可用配方
在项目目录运行 just 查看公开配方及说明,确认命令来自当前项目而不是上级目录中的另一个 justfile。
- 02
运行无副作用配方
先执行查看版本、格式检查或测试类任务,观察工作目录、参数和环境变量是否正确传递。
- 03
再接入写入型任务
对生成、清理或部署配方先阅读全部命令和依赖,在测试分支运行并检查差异后再用于正式流程。
使用建议
- 为会删除、发布或覆盖数据的配方使用清晰名称和显式确认,不要隐藏在普通依赖链中。
- 团队应固定 just 最低版本和 shell,避免新语法或平台差异让自动化悄悄失效。
- 不要把密钥写进 justfile;dotenv 自动加载也要限制文件权限并避免输出环境。
故障排查与卸载方法
Windows 提示找不到 sh 或命令语法错误怎么办?
明确安装并配置所需 shell,或把 justfile 的 shell 设置改为 PowerShell 或 cmd;随后逐条调整引号、路径分隔和变量语法。
just 运行了错误目录中的配方怎么办?
just 会从子目录向上查找 justfile。先确认当前路径和实际使用的文件,再为自动化指定项目根目录,避免同名上级配方被误用。
- 移除程序并检查自动化依赖先搜索本地脚本、CI 和开发文档中的 just 调用,迁移或停用后再删除 PATH 项和可执行文件;项目 justfile 可继续保留。
常见问题
just 是构建系统吗?
不是。just 是项目命令执行器,用 justfile 为现有编译、测试、部署或脚本命令提供统一入口,不负责像构建系统那样追踪文件依赖和增量产物。
Windows 使用 just 是否必须安装 sh?
默认配方常依赖类 Unix shell,可使用 Git for Windows 等提供的 sh;也可以在 justfile 中明确配置 PowerShell 或 cmd。团队应统一 shell,避免同一配方在不同机器表现不同。
可以直接运行陌生仓库中的 justfile 吗?
不建议。配方会以当前用户权限执行任意命令,还可能读取环境变量或 dotenv 文件。运行前应逐行审查配方、依赖和调用脚本,并先在低权限测试环境执行。
下载时需要提取码吗?
夸克网盘无需提取码;百度网盘所需的四位提取码会直接显示在下载入口旁。