如何在Nix项目中使用Qt及其子模块的调试构建版本？

问题背景 #

基于Stack Overflow相关文章及Nixpkgs 22.05版本的qtbase.nix文件，尝试在default.nix中配置带调试符号的Qt 5开发环境，首次配置代码如下：

with import <nixpkgs> {};
stdenv.mkDerivation {
    name = "myapp";
    buildInputs = [ 
        (qt5.qtbase.override { debug = true; }) 
        qt5.qtdeclarative 
        qt5.qtgraphicaleffects 
        qt5.qtimageformats 
        qt5.qtquickcontrols2 
        qt5.qttools 
        ...unrelated deps... 
    ];
}

调用nix-shell时触发Qt版本冲突错误：

Error: detected mismatched Qt dependencies:
    /nix/store/2w9sd3z24hhxvllk47xwflwcsh318k1q-qtbase-5.15.3-dev
    /nix/store/74ly900da8fi9b5vvmyqzi4yqa84p0sz-qtbase-5.15.3-dev

二次尝试（仍失败） #

猜测Qt子模块依赖未被完全覆盖，手动逐个修改子模块的依赖配置：

with import <nixpkgs> {};

let myqtbase = qt5.qtbase.override { debug = true; }; in
let myqtdecl = qt5.qtdeclarative.override { qtbase = myqtbase; }; in

stdenv.mkDerivation {
    name = "myapp";
    buildInputs = [
        myqtbase
        myqtdecl
        (qt5.qtgraphicaleffects.override { qtdeclarative = myqtdecl; })
        (qt5.qtimageformats.override { qtbase = myqtbase; })
        (qt5.qtquickcontrols2.override { qtdeclarative = myqtdecl; })
        (qt5.qttools.override { qtbase = myqtbase; qtdeclarative = myqtdecl; })
        ...unrelated deps... 
    ];
}

但执行后仍出现相同的qtbase版本冲突，无法定位冲突来源。

解决方法 #

问题核心是Qt模块的传递依赖未被完全覆盖，部分深层依赖的Qt子模块仍会引用默认的非调试版qtbase。正确做法是使用overrideScope'批量覆盖整个Qt 5套件的配置，确保所有子模块统一使用调试版qtbase：

with import <nixpkgs> {};

let
  # 批量修改Qt 5套件，强制所有子模块使用调试版qtbase
  debugQt5 = qt5.overrideScope' (self: super: {
    qtbase = super.qtbase.override { debug = true; };
  });
in
stdenv.mkDerivation {
  name = "myapp";
  buildInputs = [
    debugQt5.qtbase
    debugQt5.qtdeclarative
    debugQt5.qtgraphicaleffects
    debugQt5.qtimageformats
    debugQt5.qtquickcontrols2
    debugQt5.qttools
    ...unrelated deps...
  ];
}

原理说明 #

• overrideScope'是Nixpkgs用于批量修改一组包依赖的工具，会递归让所有Qt 5子模块继承自定义的调试版qtbase，避免手动逐个覆盖时遗漏传递依赖。
• 单个override仅修改当前包的配置，但它的依赖（如qtdeclarative依赖的其他Qt子模块）仍会使用默认版本，这就是导致冲突的根本原因。

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