Devbox：用 devbox.json 与 Nix 打造可复现开发环境
Devbox 用一份 devbox.json 声明开发环境依赖，底层 Nix 解析出记录解析结果的 devbox.lock——任何开发者或 CI 从同一提交起 devbox shell 尽量使用锁定的工具版本，但系统与架构仍影响结果。本文讲清原理、上手与 CI 集成。
直接回答：Devbox 是基于 Nix 的 CLI，但不需要你懂 Nix 语言——devbox.json 里声明依赖（如 nodejs@20、go@1.22），版本解析固化进 devbox.lock，提交两个文件后，团队使用锁定的依赖解析结果；操作系统、架构、外部服务和未锁定脚本依赖仍会产生差异。包依赖与 PATH 可按项目隔离，但这不是隔离不可信代码的安全沙箱，脚本仍能读写用户文件。
工作原理
- 沙箱安装：包装进隔离环境，
devbox shell期间注入 PATH，退出后全局环境原样 - 两个文件：devbox.json（人读的声明）+ devbox.lock（自动生成的精确哈希）——都进 Git
- Nix 包集合：同一工具多个版本共存无冲突（文件系统级隔离）
上手
# 安装前阅读官方安装脚本及权限要求；按官方安装说明安装 Devbox
mkdir myproject && cd myproject
devbox init
devbox add nodejs@22 go@latest
devbox shell # 进入环境，核对 node -v；CI 固定实际选定版本
脚本与初始化钩子
{
"packages": ["nodejs@22"],
"shell": {
"scripts": { "dev": "npm run dev", "test": "npm test" },
"init_hook": ["npm ci"]
}
}
devbox run dev 统一团队命令入口；init_hook 进 shell 自动装依赖。
Dockerfile 生成与 CI
devbox generate dockerfile 把环境变成容器镜像——开发与生产环境同源；CI 里 devbox run test 减少工具版本漂移，但仍须固定应用锁文件、架构和外部依赖，不能保证逐位一致。
常见问题（FAQ）
Q：和直接学 Nix 比损失了什么？
A：表达力——复杂定制（overlay、自定义 derivation）Devbox 盖不住。是否足够取决于需要的 Nix 定制程度。
Q：和 Docker 开发环境冲突吗？
A：互补。Devbox 管"工具链版本"（编辑器、语言、CLI），Docker 管"服务依赖"（数据库、中间件）。devbox 还能生成 Dockerfile 打通两者。
Q：锁文件冲突怎么解？
A：devbox.lock 冲突时先合并 devbox.json 的真实需求，再按选定版本重新生成/更新锁文件并检查 diff；不要盲目丢弃一方依赖变更——和 package-lock.json 的处理逻辑相同。
官方参考
本文依据官方文档整理，示例未在本文中进行运行验证。生产部署需按所用版本、权限和实际负载验证。
