开发工具CLI【免费下载链接】devboxInstant, easy, and predictable development environments项目地址https://gitcode.com/GitHub_Trending/dev/devbox点击查看免费下载本指南以仓库中的 go-mod 示例 为核心完整讲解如何用 Nix 的buildGoModule函数把任意 Go 模块打包成一个 Flake 派生包再通过devbox.json的path:包引用把它纳入 Devbox 开发环境。读完本文你将掌握自定义 Flake 的完整写法、vendorSha256等关键构建参数的作用、path:/github:两类 Flake 引用的区别以及 Devbox 内部如何把这些 Flake 输出组装进最终生成的flake.nix。示例全景一个可复用的 Go Flake 模板examples/flakes/go-mod目录展示了如何在 Devbox 中构建并使用一个非 Flake 化的第三方 Go 项目示例选取的是 Ory CLI。整个示例由三部分构成文件作用examples/flakes/go-mod/flake.nix以buildGoModule构建 Ory CLI产出ory-cli输出examples/flakes/go-mod/devbox.json通过path:ory-cli#ory-cli引用本地 Flake 输出examples/flakes/go-mod/devbox.lock锁文件本地 Flake 包不在其中锁定这套结构的核心思路是任何没有现成 Nix 包的 Go 模块都可以被包一层 Flake后直接接入 Devbox。README 中明确说明该示例可以作为创建你自己模板的起点。编写 Go 模块 Flake逐字段拆解 buildGoModule先看 ory-cli/flake.nix 的整体骨架以下为该文件内容{ description This flake builds the Ory CLI using Nixs buildGoModule Function.; inputs { nixpkgs.url nixpkgs/nixos-unstable; flake-utils.url github:numtide/flake-utils; # The Ory CLI is not a flake, so we have to use the Github input and build it ourselves. ory-cli { type github; owner ory; repo cli; ref v0.2.2; flake false; }; }; outputs { self, nixpkgs, flake-utils, ory-cli }: # Use the flake-utils lib to easily create a multi-system flake flake-utils.lib.eachDefaultSystem (system: let # Define some variables that we want to use in our package build. Youll want to update version and ref above to use a different version of Ory. version 0.2.2; in { packages let pkgs import nixpkgs { inherit system; }; pname ory; name ory-${version}; in { # Build the Ory CLI using Nixs buildGoModuleFunction ory-cli pkgs.buildGoModule { inherit version; inherit pname; inherit name; # Path to the source code we want to build. In this case, its the ory-cli input we defined above. src ory-cli; # This was in the Makefile in the Ory repo, not sure if its required tags [ sqlite ]; doCheck false; # If the vendor folder is not checked in, we have to provide a hash for the vendor folder. Nix requires this to ensure the vendor folder is reproducible, and matches what we expect. vendorSha256 sha256-J9jyeLIT1pFnHOUHrzmblVCJikvY05Sw9zMz5qaDOk; # The Go Mod is named cli by default, so we rename it to ory. postInstall mv $out/bin/cli $out/bin/ory ; }; }; } ); }逐块说明其中的关键设计1. inputs三种输入的来源nixpkgs.url nixpkgs/nixos-unstable指定构建所依赖的 nixpkgs 通道flake-utils.url github:numtide/flake-utils引入多系统辅助库省去手写 4~5 套system配置ory-cli由于 Ory CLI 本身不是 Flake这里用type github把仓库作为普通源码输入ref v0.2.2锁定标签版本flake false告诉 Nix 该输入没有flake.nix只需拉取源码树。2.flake-utils.lib.eachDefaultSystem自动展开 x86_64-linux、aarch64-linux、x86_64-darwin、aarch64-darwin 等默认系统确保同一份定义在多平台都能产出packages.system.ory-cli。3.pkgs.buildGoModule核心参数pname/name包名与派生名这里name ory-${version}即ory-0.2.2src直接指向ory-cli输入即 GitHub 源码树tags [ sqlite ]为go build传入构建标签示例注释指出它来自 Ory 仓库的 MakefiledoCheck false跳过go test阶段可缩短构建时间vendorSha256当源码仓库未提交vendor/目录时Nix 要求提供 vendor 目录的 SRI 哈希以保证可复现构建。实际写入的是sha256-J9jyeLIT1pFnHOUHrzmblVCJikvY05Sw9zMz5qaDOkpostInstall安装后处理把默认名为cli的二进制重命名为ory。4. 可复用的版本变量version 0.2.2与 inputs 里的ref必须保持一致替换成新版本时只需同步修改这两处。实操提示如果你首次编写自己的 FlakevendorSha256可以先用任意占位值如lib.fakeSha256或触发构建Nix 会报错并打印期望的哈希把它回填即可。在 devbox.json 中引用本地 Flake 输出README 给出的最小引用方式是{ packages: [ path:ory-cli ], ... }仓库里实际生效的 devbox.json 使用了更精确的写法——带上#ory-cli属性路径{ packages: [ path:ory-cli#ory-cli ], shell: { init_hook: null }, nixpkgs: { commit: f80ac848e3d6f0c12c52758c0f25c10c97ca3b62 } }这里#ory-cli表示安装该 Flake 的packages.system.ory-cli输出若不写属性路径则默认取 Flake 的 default 输出。这正是 Nixinstallable 语法在 Devbox 中的落地形态。从源码看nix/flake/flakeref.go 中的ParseInstallable完整实现了这套语法#后是属性路径AttrPath以 URL fragment 编码^后是输出规格Outputs逗号分隔*表示安装全部输出path:前缀用于明确标识路径型 Flake避免与普通 Devbox 包名如nixpkgs产生歧义。internal/devpkg/pkgtype/flake.go 中的IsAmbiguous进一步规定了消歧规则带#attr_path的字符串一定是 Flake路径型 Flake 必须写path:前缀或以/、./开头间接引用如裸nixpkgs则按 Devbox 包处理。本地 Flake 的解析与锁定行为path:引用的本地 Flake 有几个值得注意的底层行为见 internal/devpkg/package.go相对路径被归一为绝对路径setInstallable会把相对项目目录的 Flake 路径拼接为绝对路径filepath.Join(projectDir, i.Ref.Path)保证后续 Nix 调用不受工作目录影响不进入 devbox.locknewPackage的 resolve 逻辑中有一条明确注释Dont lock flakes that are local paths本地路径型 Flake 直接跳过锁定。因此 devbox.lock 中packages为空对象是预期状态哈希基于 flake.nix 内容Package.Hash()对本地 Flake 使用flake.nix的内容哈希文件一变哈希即变确保用户始终拿到最新定义flake.nix的存放路径为 examples/flakes/go-mod/ory-cli/flake.nix。Devbox 如何把 Flake 包组装进环境你添加的 Flake 包并不会直接进入 shell而是会被 Devbox 聚合进一份生成的顶层 flake.nix模板见 internal/shellgen/tmpl/flake.nix.tmpl。组装过程由 internal/shellgen/flake_input.go 的flakeInputs完成对每个 Nix 包调用pkg.FlakeInstallable()取得其flake.Ref按 Flake URL 分组getOrAppend相同来源的包合并到同一个 input避免重复每个 input 的名字由devpkg.Package.FlakeInputName()生成本地路径型为目录名-哈希GitHub 型为gh-owner-repo-ref非法字符统一替换为-非 nixpkgs 的 Flake 包通过flakeName.属性路径形式写入buildInputs见BuildInputs中对f.Name . attributePath的拼接。生成的flake.nix会把每个 Flake input 的 URLURLWithCaching写进inputs再以mkShell { buildInputs [...] }形式注入环境。若包已存在于 Nix 二进制缓存还会用builtins.fetchClosure直接从缓存拉取 store path避免本地重复编译。因此当你运行devbox shell或devbox run时ory-cliFlake 的ory二进制就会进入 PATH。本地 Flake 与远程 Flake两种引用方式对照结合仓库中的 flakes 示例总览除了本示例的本地path:引用Devbox 同样支持远程 GitHub Flake{ packages: [ github:nixos/nixpkgs/5233fd2ba76a3accb5aaa999c00509a11fd0793c#hello, github:F1bonacc1/process-compose ], shell: { init_hook: null }, nixpkgs: { commit: f80ac848e3d6f0c12c52758c0f25c10c97ca3b62 } }github:owner/repo/ref#output安装指定提交/分支上的 Flake 输出不带#时安装该仓库 Flake 的 default 输出两种引用都基于同一套flake.Ref/flake.Installable解析器nix/flake/flakeref.gogithub:型引用会解析出Owner、Repo、Ref/Rev并可附带dir、narHash等查询参数。版本要求与适用前提本示例要求Devbox 0.4.7 或更高版本该版本开始支持 Flake 包引用README 原文说明当前仓库的 devbox.json 与 flake.nix 均基于此能力构建需要本机安装 NixDevbox 会在缺失时自动安装见 internal/nix/install.go 的EnsureNixInstallednixpkgs.commit固定了 nixpkgs 输入保证构建可复现若使用github:引用的 Flake 不存在于二进制缓存首次构建会从源码编译耗时较长。用测试用例验证 Flake 集成流程仓库的测试脚本 testscripts/packages/flakes.test.txt 直接验证了本地 Flake 的完整闭环exec devbox add path:my-flake exec devbox run hello其配套的my-flake/flake.nix定义了一个简单的packages.default pkgs.hello输出。这说明devbox add path:xxx后即可直接通过devbox run使用该 Flake 提供的程序——这正是本示例path:ory-cli#ory-cli引用的工作方式。你可以仿照此模式为自己的 Go 模块编写flake.nix再以同样方式接入 Devbox 环境实现任意 Go 项目一键进入可复现开发环境。赞分享开发工具CLI【免费下载链接】devboxInstant, easy, and predictable development environments项目地址https://gitcode.com/GitHub_Trending/dev/devbox点击查看免费下载相关推荐使用 Nix Flake 构建与集成 FTXUIC 终端 UI 库的 Nix 安装与依赖指南使用 Nix Flake 构建与集成 FTXUIC 终端 UI 库的 Nix 安装与依赖指南 本文以 doc/installation_nix.md htUI组件在 Nix Flake 中模块化组织 devenv使用 flake-parts 构建声明式开发环境在 Nix Flake 中模块化组织 devenv使用 flake parts 构建声明式开发环境 本文聚焦 devenv 与 flake parts htt开发工具CLI在 nix-darwin 中使用 Home Manager 模块Flake 集成配置完全指南在 nix darwin 中使用 Home Manager 模块Flake 集成配置完全指南 导读 本指南讲解如何在 macOS 的 nix darwin 配配置管理CLI上一篇突破Android权限壁垒LSPosed动态权限Hook实战指南下一篇《数学要素》从加减乘除到机器学习25章从0到1创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考