Nix Flake中writeScriptShellBin无法绑定Python包，仅devShell可用

核心问题定位 #

devShell会自动加载完整的环境变量（包括Python的site-packages路径、libclang的动态库路径），但writeScriptShellBin生成的脚本默认使用Nix构建时的纯净环境，不会自动继承这些依赖路径，导致Python找不到clang.cindex。

具体修复方法 #

方法1：手动在脚本中注入环境变量 #

修改writeScriptShellBin的脚本内容，直接添加Python依赖路径和libclang动态库路径：

writeScriptShellBin "cs" ''
  export PYTHONPATH="${lib.makeSearchPathOutput "lib" "python3/site-packages" [ your-custom-libclang banana-vera ]}"
  export LD_LIBRARY_PATH="${lib.makeLibraryPath [ your-custom-libclang ]}"
  # 替换成你的合规检查工具执行命令
  python3 -m banana_vera.check "$@"
''

这里your-custom-libclang是你构建的带Python绑定的libclang包，banana-vera是原工具包。lib.makeSearchPathOutput会自动拼接正确的site-packages路径，LD_LIBRARY_PATH保证动态库能被加载。

方法2：用python.withPackages构建统一Python环境 #

把banana-vera和libclang打包进同一个定制Python环境，再基于这个环境生成脚本：

let
  customPython = python311.withPackages (ps: [
    ps.banana-vera # 若banana-vera不在默认包集合，替换为你的自定义包
    your-custom-libclang
  ]);
in
writeScriptShellBin "cs" ''
  ${customPython}/bin/python3 -m banana_vera.check "$@"
''

这种方式更简洁，withPackages会自动处理所有依赖路径，脚本直接调用定制的Python解释器，无需手动设置环境变量。

方法3：用symlinkJoin整合依赖环境 #

如果banana-vera是独立的Derivation，用symlinkJoin合并它和libclang的Python路径，再在脚本中指定PYTHONPATH：

let
  combinedEnv = symlinkJoin {
    name = "banana-vera-with-libclang";
    paths = [ banana-vera your-custom-libclang ];
    postBuild = ''
      mkdir -p $out/lib/python3/site-packages
      ln -s ${banana-vera}/lib/python3/site-packages/* $out/lib/python3/site-packages/
      ln -s ${your-custom-libclang}/lib/python3/site-packages/* $out/lib/python3/site-packages/
    '';
  };
in
writeScriptShellBin "cs" ''
  export PYTHONPATH="${combinedEnv}/lib/python3/site-packages"
  export LD_LIBRARY_PATH="${lib.makeLibraryPath [ your-custom-libclang ]}"
  ${banana-vera}/bin/banana-vera-check "$@"
''

关键注意事项 #

• 确认your-custom-libclang的Derivation已将Python绑定输出到lib/python3/site-packages/clang目录，动态库在lib目录下。
• 测试脚本时直接用nix run执行生成的cs命令，不要在devShell内测试，避免环境干扰。
• 若从Nixpkgs获取libclang，优先使用pkgs.libclang.python版本（如果存在），避免版本不兼容。

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