如何在NixOS configuration.nix中获取系统版本以实现多版本兼容？

核心思路 #

无需手动生成版本文件，直接利用NixOS内置的工具函数和系统文件实现版本条件分支，完全原生支持。

方法1：基于配置声明的stateVersion判断 #

config.system.stateVersion是你在配置中指定的NixOS版本标识，适合基于目标配置版本做分支（推荐方式，符合声明式理念）：

{ config, pkgs, lib, ... }:

let
  # 判断是否为23.05及以上版本
  is2305OrNewer = lib.versionAtLeast config.system.stateVersion "23.05";
  # 判断是否为20.03版本（20.03早于21.05）
  is2003 = lib.versionOlder config.system.stateVersion "21.05";
in {
  # 全局系统包配置
  environment.systemPackages = [
    # 所有版本通用的包
    pkgs.vim
    pkgs.git
    # 版本专属包：23.05用新版本，20.03用旧版本
    (if is2305OrNewer then pkgs.newPackage else pkgs.oldPackage)
  ];

  # 服务配置的条件分支：仅在23.05启用新服务
  services.newService.enable = is2305OrNewer;
  # 仅在20.03保留旧服务
  services.legacyService.enable = is2003;
}

方法2：基于当前运行系统的版本判断 #

如果需要适配当前正在运行的系统版本，可以直接读取系统原生的/etc/os-release文件解析版本：

{ pkgs, lib, ... }:

let
  # 读取并解析系统版本文件
  osRelease = lib.parseKeyValuePairs (lib.fileContents "/etc/os-release");
  osVersion = osRelease.VERSION_ID;
  # 版本判断
  is2305 = lib.versionAtLeast osVersion "23.05";
  is2003 = lib.versionEqual osVersion "20.03";
in {
  environment.systemPackages = [
    pkgs.zsh
    # 根据系统版本选择对应包
    (if is2305 then pkgs.packageFor2305 else pkgs.packageFor2003)
  ];
}

方法3：基于nixpkgs版本判断 #

NixOS版本与nixpkgs版本一一对应，也可以直接通过pkgs.lib.version判断nixpkgs版本：

{ pkgs, lib, ... }:

let
  nixpkgsVersion = pkgs.lib.version;
  is2305 = lib.versionAtLeast nixpkgsVersion "23.05";
in {
  environment.systemPackages = [
    (if is2305 then pkgs.latestTool else pkgs.legacyTool)
  ];
}

注意事项 #

• 优先使用stateVersion方式，它是配置声明的目标版本，避免运行环境与配置目标版本不一致的问题。
• Nix内置的lib.versionAtLeast、lib.versionOlder、lib.versionEqual函数能正确处理语义化版本号的比较，无需自己写字符串判断逻辑。
• 如果某个软件包在不同NixOS版本中的属性路径或名称发生变化，同样可以用条件分支适配（比如pkgs.oldName vs pkgs.newName）。

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