如何避免Nixpkgs overlay在组合依赖时被重复应用？

你遇到的问题是因为overlayBar和overlayBaz都通过composeExtensions内置了overlayFoo，当把它们同时加入overlays列表时，overlayFoo会被执行两次。以下是几种实用的解决方法：

方法1：拆分Overlay，单独引入基础Overlay #

把overlayFoo从overlayBar和overlayBaz中剥离出来，只在overlays列表中引入一次，后续的扩展Overlay直接基于它修改：

# 基础Overlay，只定义通用修改
overlayFoo = self: super: {
  # ... 你的基础配置
};

# 仅保留各自的扩展逻辑，不再包含overlayFoo
overlayBar = self: super: {
  # ... 基于overlayFoo的后续修改
};

overlayBaz = self: super: {
  # ... 基于overlayFoo的后续修改
};

# 使用时先加载基础Overlay，再加载扩展Overlay
pkgs = import nixpkgs {
  inherit system;
  overlays = [overlayFoo overlayBar overlayBaz];
};

这种方式最直观，逻辑清晰，适合大多数场景。

方法2：给基础Overlay添加应用标记 #

如果不想修改现有Overlay的组合结构，可以在overlayFoo中添加一个“已应用”标记，检查到标记存在时直接返回原属性集，避免重复执行：

overlayFoo = self: super:
  # 检查是否已经应用过overlayFoo
  if self ? __overlayFooApplied then super else
  super // {
    __overlayFooApplied = true; # 添加标记
    # ... 你的基础配置
  };

# 保持原有的组合方式不变
overlayBar = pkgs.lib.fixedPoints.composeExtensions overlayFoo (self: super: {
  # ...
});

overlayBaz = pkgs.lib.fixedPoints.composeExtensions overlayFoo (self: super: {
  # ...
});

# 使用方式无需修改，overlayFoo只会执行一次
pkgs = import nixpkgs {
  inherit system;
  overlays = [overlayBar overlayBaz];
};

这种方法适合需要让Overlay自包含、不想调整外部使用方式的场景。

方法3：合并为单个复合Overlay #

把overlayFoo、overlayBar和overlayBaz合并成一个整体Overlay，确保overlayFoo只被应用一次：

overlayFoo = self: super: {
  # ...
};

# 提取overlayBar和overlayBaz的核心扩展逻辑
overlayBarCore = self: super: {
  # ... 原overlayBar中除了overlayFoo的部分
};

overlayBazCore = self: super: {
  # ... 原overlayBaz中除了overlayFoo的部分
};

# 先应用overlayFoo，再依次应用两个扩展
combinedOverlay = pkgs.lib.fixedPoints.composeExtensions overlayFoo
  (pkgs.lib.fixedPoints.composeExtensions overlayBarCore overlayBazCore);

# 使用时只加载合并后的Overlay
pkgs = import nixpkgs {
  inherit system;
  overlays = [combinedOverlay];
};

这种方式适合把相关Overlay打包成一个独立单元，方便复用。

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