如何在nix-shell中正确添加darwin.apple_sdk 解决Clang找不到macOS SDK框架问题

方案1：创建包含完整Apple SDK的nix-shell #

在项目根目录创建shell.nix文件，写入以下内容：

{ pkgs ? import <nixpkgs> {} }:
pkgs.mkShell {
  buildInputs = with pkgs; [
    clang
    # 引入完整Apple SDK本体
    darwin.apple_sdk.sdk
    # 导入所有SDK框架，无需逐个添加
  ] ++ builtins.attrValues pkgs.darwin.apple_sdk.frameworks;
}

在项目目录执行nix-shell即可进入包含完整SDK的编译环境，直接执行编译命令不会再出现框架缺失错误。

方案2：将完整SDK集成到home-manager全局配置 #

修改你的home-manager配置文件（通常为~/.config/nixpkgs/home.nix），添加以下配置：

{ pkgs, ... }:
{
  home.packages = with pkgs; [
    clang
    darwin.apple_sdk.sdk
  ] ++ builtins.attrValues pkgs.darwin.apple_sdk.frameworks;

  # 全局配置编译器搜索路径
  home.sessionVariables = {
    NIX_LDFLAGS = "-F${pkgs.darwin.apple_sdk.sdk}/Library/Frameworks";
    CPPFLAGS = "-F${pkgs.darwin.apple_sdk.sdk}/Library/Frameworks";
    LIBRARY_PATH = "${pkgs.darwin.apple_sdk.sdk}/usr/lib";
    C_INCLUDE_PATH = "${pkgs.darwin.apple_sdk.sdk}/usr/include";
    CPLUS_INCLUDE_PATH = "${pkgs.darwin.apple_sdk.sdk}/usr/include";
  };
}

保存后执行home-manager switch生效，后续所有终端会话的Clang都可直接定位全部SDK框架，不需要单独为每个项目添加框架依赖。

方案3：脱离Nix沙箱使用原生系统工具链 #

无需额外创建未安装Nix的用户，可通过以下方式直接使用系统原生Xcode命令行工具链：

• 临时切换原生工具链：编译前执行命令export PATH="/usr/bin:$PATH"，此时调用的clang、ld均为系统原生版本，会自动读取系统安装的SDK框架。
• 临时关闭Nix构建纯度限制：执行nix相关构建命令时添加--impure参数，允许构建过程读取系统路径下的SDK资源。
• 全局调整路径优先级：在shell配置文件（.zshrc/.bashrc等）末尾添加export PATH="$PATH:/run/current-system/sw/bin:$HOME/.nix-profile/bin"，让系统原生路径优先级高于Nix路径，默认调用系统工具，需要使用Nix安装的软件时再手动指定路径即可。

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