在Nix环境下编译Rust程序时如何修复头文件缺失问题

架构老林

2026-4-13

嘿，我之前也碰到过一模一样的问题！NixOS的依赖隔离特性虽然能避免很多乱七八糟的冲突，但有时候确实会让Rust编译找不到系统库的头文件，别慌，咱们一步步来解决～

方法一：用`nix-shell`临时构建依赖环境

这是最快速的临时解决方案，适合快速验证编译：

在你的项目根目录创建一个名为shell.nix的文件，内容如下：

{ pkgs ? import <nixpkgs> {} }:
pkgs.mkShell {
  buildInputs = with pkgs; [
    rustc
    cargo
    parted  # 对应你依赖的libparted库，提供头文件和动态库
    procps  # sysinfo库编译需要的系统依赖
    glibc   # 基础系统头文件，很多Rust crate都会用到
  ];
}

在终端里运行nix-shell，等待环境构建完成后，你会进入一个包含所有所需依赖的shell环境
最后执行cargo build，这时候Cargo就能顺利找到缺失的头文件啦

方法二：用`cargo-nix`生成Nix构建配置（更符合Nix工作流）

如果打算长期用Nix维护这个项目，推荐用这种方式，能让项目构建完全纳入Nix的管理：

首先进入一个有Rust环境的shell（比如用上面的nix-shell），安装cargo-nix：
```
cargo install cargo-nix
```
生成Cargo.lock文件（如果还没有的话）：
```
cargo generate-lockfile
```
生成Nix构建配置文件：
```
cargo nix init
```
现在项目根目录会多出Cargo.nix和default.nix，直接用Nix构建项目即可：
```
nix-build
```