如何用Nix Flake创建与Shell路径无关的Python可执行文件并解决构建错误？

1. 修复文件不存在错误 #

首次构建报错通常是因为源码路径或脚本入口配置错误：

• 确保src指向正确的项目目录（比如./.代表当前目录），且项目中存在指定的Python入口文件（如app.py）。
• 在构建阶段明确指定依赖安装路径到$out，避免依赖找不到的问题。

2. 消除对/usr/bin/bash的依赖 #

可执行文件依赖系统bash是因为脚本shebang未指向Nix环境内的bash，解决方法：

• 在派生包的nativeBuildInputs中加入pkgs.bash。
• 使用Nix自带的patchShebangs工具，自动替换脚本的shebang为Nix Store中的bash路径（如/nix/store/xxx-bash/bin/bash），确保可执行文件跨环境兼容。

3. 解决buildInputs"期望列表却得到集合"错误 #

devShell的buildInputs要求传入列表类型，若直接传入单个派生包会触发类型错误：

• 将派生包直接放入列表[]中；如果是单个包，也可以用pkgs.lib.singleton包裹（如pkgs.lib.singleton my-streamlit-app），确保输入为列表格式。

完整Flake配置示例 #

{
  description = "Portable Python + Streamlit environment";

  inputs = {
    nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
    flake-utils.url = "github:numtide/flake-utils";
  };

  outputs = { self, nixpkgs, flake-utils }:
    flake-utils.lib.eachDefaultSystem (system:
      let
        pkgs = import nixpkgs { inherit system; };
        python = pkgs.python311;
        # 构建自定义Streamlit可执行包
        my-streamlit-app = pkgs.stdenv.mkDerivation {
          name = "my-streamlit-app";
          src = ./.; # 指向你的项目源码目录
          nativeBuildInputs = [
            python.pkgs.setuptools
            pkgs.bash
            pkgs.coreutils
          ];
          buildInputs = [ python ];

          buildPhase = ''
            # 将Streamlit安装到Nix输出目录
            ${python.interpreter} -m pip install streamlit --prefix=$out
          '';

          installPhase = ''
            mkdir -p $out/bin
            # 生成可执行脚本
            cat > $out/bin/my-app <<EOF
#!/usr/bin/env bash
${python.interpreter} -m streamlit run ${src}/app.py
EOF
            chmod +x $out/bin/my-app
            # 修复shebang，消除系统bash依赖
            patchShebangs $out/bin/my-app
          '';
        };
      in
      {
        packages.default = my-streamlit-app;
        devShells.default = pkgs.mkShell {
          # 用列表形式传入buildInputs，解决类型错误
          buildInputs = [
            python
            python.pkgs.streamlit
            my-streamlit-app
          ];
          shellHook = ''
            echo "Dev shell ready: run 'my-app' to start your Streamlit app"
          '';
        };
      }
    );
}

验证步骤 #

1. 运行nix develop进入devShell，直接执行my-app即可启动Streamlit应用。
2. 运行nix build生成可执行文件，执行head -n1 result/bin/my-app检查shebang，会显示Nix Store中的bash路径，而非/usr/bin/bash。

内容的提问来源于stack exchange，提问作者Pierre-olivier Gendraud