nix-shell中执行python setup.py install报错无法安装Python包如何解决

Nix将环境级Python的site-packages目录放在只读的/nix/store路径下，默认安装逻辑尝试写入该路径就会触发权限报错，同时Nix封装的Python解释器默认的包搜索路径会忽略非Nix规范生成的第三方安装路径，才会出现看似安装成功但无法导入的问题。

该方案完全符合Nix设计规范，无需手动调整路径，长期使用稳定性最高：

• 若待安装包是PyPI公开包，直接在foo.nix的依赖列表中添加对应包名即可，示例配置：

{ pkgs ? import <nixpkgs> {} }:
pkgs.mkShell {
  buildInputs = with pkgs; [
    python37
    python37Packages.your-target-package # 替换为实际要安装的PyPI包名
    python37Packages.pip
    python37Packages.virtualenv
  ];
}

• 若待安装包是本地开发的自定义包，先通过Nix的buildPythonPackage封装后再加入依赖，示例配置：

{ pkgs ? import <nixpkgs> {} }:
let
  myCustomPkg = pkgs.python37Packages.buildPythonPackage {
    pname = "my-custom-pkg";
    version = "0.1";
    src = ./your-pkg-dir; # 替换为setup.py所在的本地目录路径
    propagatedBuildInputs = with pkgs.python37Packages; [
      # 填写自定义包依赖的其他Python包
    ];
  };
in pkgs.mkShell {
  buildInputs = [
    pkgs.python37
    myCustomPkg
  ];
}

配置完成后重新进入nix-shell，无需手动执行setup.py即可直接导入对应包。

无需修改Nix配置，仅在当前shell环境生效：

• 临时用户目录安装：
  执行pip install --user .代替手动执行setup.py，若安装完成后仍无法导入，执行以下命令临时添加搜索路径即可：
  export PYTHONPATH=$(python -m site --user-site):$PYTHONPATH
• 正常使用virtualenv：
  之前操作报错是因为Nix环境下默认创建的virtualenv会软链接到/nix/store的只读资源，创建时添加--always-copy参数即可规避问题：

virtualenv --always-copy venv
source venv/bin/activate
pip install .

执行完成后直接就能导入安装的包，无需额外调整路径参数。

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