使用node2nix打包带GraphicsMagick依赖的Node脚本时遇wrapProgram未找到错误

最近我在打包一个依赖GraphicsMagick的Node.js脚本，想用node2nix生成对应的Nix derivation，结果在自定义覆盖derivation的时候碰到了wrapProgram: command not found的错误。折腾了一番终于搞定，下面分享我的解决过程和复现步骤。

问题复现步骤 #

如果你想自己复现这个问题，可以跟着下面的步骤来：

• 打开一个空目录的Shell会话
• 初始化Node项目：npm init -y
• 安装GraphicsMagick的Node绑定：npm install gm
• 用node2nix生成配置文件：node2nix -l package-lock.json
• 尝试在default.nix里添加自定义的postInstall逻辑，调用wrapProgram来包装脚本并注入GraphicsMagick的路径，运行nix-build就会触发wrapProgram: command not found错误

排查与解决过程 #

一开始我有点懵，后来想起wrapProgram是Nix生态里makeWrapper包提供的工具，问题肯定是derivation里没引入这个依赖。

1. 确认依赖缺失：node2nix默认生成的derivation里，buildInputs只有nodejs，没有包含makeWrapper，所以构建环境里找不到这个命令。
2. 添加makeWrapper到构建依赖：
   打开生成的default.nix，找到构建Node包的那个mkDerivation块，把pkgs.makeWrapper加到buildInputs里，同时在postInstall里写包装逻辑：

   pkgs.stdenv.mkDerivation {
     name = "your-project-name";
     src = ./.;
     buildInputs = [ pkgs.nodejs pkgs.makeWrapper ]; # 这里添加makeWrapper
     inherit (pkgs.nodePackages) nodeDependencies;
   
     postInstall = ''
       # 替换成你的脚本实际路径
       wrapProgram $out/bin/your-script \
         --prefix PATH : ${pkgs.graphicsmagick}/bin
     '';
   }
   

3. 验证修复：重新运行nix-build，这次wrapProgram能正常执行，脚本也会被正确包装，运行时能找到GraphicsMagick的二进制文件了。

另外，如果你不想直接修改default.nix，也可以在package.nix里调整依赖，但直接修改default.nix的buildInputs是最直观的方案。

总结一下关键要点 #

• wrapProgram不是Nix默认环境自带的，必须显式把makeWrapper加入到buildInputs
• 包装脚本时，一定要用--prefix PATH把依赖的二进制目录（比如GraphicsMagick的bin）注入到程序的运行环境里
• node2nix不会自动包含makeWrapper，所以只要你需要自定义包装逻辑，就得手动加这个依赖

内容的提问来源于stack exchange，提问作者Jay