Nix构建阶段报错‘fatal: not a git repository’，.git目录未复制？

问题根源 #

Nix构建沙盒默认只会复制仓库中Git已追踪的文件，.git目录和未拉取的子模块目录不会被包含到临时构建目录里，所以执行git submodule update --init --recursive时会提示“fatal: not a git repository”。而nix develop是直接在本地Git仓库目录运行，能正常访问.git，因此命令可执行。

可行解决方案 #

1. 用builtins.fetchGit自动拉取子模块（推荐）

这是最符合Nix构建理念的方式，让Nix自动拉取仓库及所有子模块，无需手动执行Git命令。在Flake的src配置中写入：

src = builtins.fetchGit {
  url = ./.; # 指向本地Agregore仓库路径
  submodules = true; # 开启子模块拉取
  rev = "填入当前仓库的Commit哈希"; # 必须指定rev，保证构建可复现
};

配置完成后，构建环境的src已包含所有子模块的完整内容，无需再执行git submodule update命令。

2. 强制包含.git目录（不推荐）

如果确实需要在构建阶段执行Git命令，可通过lib.cleanSourceWith强制将.git目录纳入构建环境，但这种方式会破坏构建纯净性，还会增加构建体积：

src = lib.cleanSourceWith {
  src = ./.;
  filter = path: type: 
    type == "directory" || (baseNameOf path != ".git" && baseNameOf path != ".gitmodules");
};

注意：该方式可能导致构建结果随本地Git状态变化，不适合生产环境。

3. 手动拉取子模块（适合复杂场景）

若子模块有特殊需求，可单独用fetchFromGitHub或fetchGit拉取每个子模块，再复制到对应目录：

let
  # 示例：拉取Agregore的某个子模块
  ipfsSubmodule = fetchFromGitHub {
    owner = "ipfs";
    repo = "js-ipfs";
    rev = "对应子模块的Commit哈希";
    sha256 = "nix-prefetch-url --unpack 该子模块URL后得到的哈希";
  };
in stdenv.mkDerivation {
  # ...其他构建配置
  postUnpack = ''
    # 将子模块复制到项目对应目录
    cp -r ${ipfsSubmodule} ./src/ipfs
  '';
};

额外提示 #

作为Flake新手，优先选择第一种方案，既能保证构建可复现性，又能避免手动处理子模块的麻烦。Nix构建和nix develop的核心区别在于构建环境是完全纯净的临时目录，不依赖本地仓库的Git状态，这也是Nix保证构建一致性的关键。

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