NixOS中VSCode终端nix-shell编译依赖高版本GLIBC问题

问题场景 #

我的NixOS系统基于23.05频道运行，通过configuration.nix引入了nixos-unstable频道的unstable.vscode.fhs（该频道GLIBC版本为2.38，23.05频道自带GLIBC 2.37），VSCode本身运行正常，但构建C++/CMake项目时出现差异：

• 在VSCode内置终端进入项目目录，执行nix-shell后用CMake构建，生成的可执行文件依赖GLIBC 2.38（经readelf和nm检测，是fmod符号导致的依赖）
• 但在系统普通终端执行完全相同的操作，生成的程序无此高版本GLIBC依赖
• 确认过CMake、编译器等工具版本完全一致，均指向Nix存储中的同一路径

根因分析 #

经排查，问题源于VSCode的FHS环境自动注入的NIX_CFLAGS_COMPILE、NIX_CFLAGS_LINK、NIX_LDFLAGS环境变量，这些变量携带了nixos-unstable频道的依赖信息，导致构建过程中链接了高版本GLIBC的符号。

解决方案 #

1. VSCode内置终端的nix-shell场景 #

在项目的shell.nix中添加shellHook，清除干扰环境变量：

{ pkgs ? import <nixpkgs> {} }:
pkgs.mkShell {
  # 保留你原有的shell配置
  shellHook = ''
    unset NIX_CFLAGS_COMPILE
    unset NIX_CFLAGS_LINK
    unset NIX_LDFLAGS
  '';
}

这个方法能解决终端内nix-shell的构建问题，但对VSCode通过nix-environment插件构建的场景无效。

2. nix-environment插件构建场景 #

需要从源头清除VSCode启动时的环境变量杂质，有几种方式：

方式一：在configuration.nix中全局或针对VSCode配置

# 全局会话级别清除（影响所有GUI程序）
services.xserver.displayManager.sessionCommands = ''
  unset NIX_CFLAGS_COMPILE
  unset NIX_CFLAGS_LINK
  unset NIX_LDFLAGS
'';

# 或仅针对VSCode单独配置
programs.vscode = {
  enable = true;
  package = unstable.vscode.fhs;
  extraEnv = {
    NIX_CFLAGS_COMPILE = "";
    NIX_CFLAGS_LINK = "";
    NIX_LDFLAGS = "";
  };
};

方式二：修改VSCode插件配置

在VSCode的settings.json中，给nix-environment插件添加shellHook配置：

{
  "nix-environment.environments": {
    "你的环境名称": {
      "shellHook": "unset NIX_CFLAGS_COMPILE NIX_CFLAGS_LINK NIX_LDFLAGS"
    }
  }
}

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