使用Nix定义的tmux插件触发127错误求助

开发者阿泽

2026-6-17

解决tmux插件返回127错误的方案（Nix + Home-manager + macOS）

核心原因

tmux启动时的环境变量PATH与手动终端的PATH不一致，Nix管理的工具/脚本路径未被tmux加载，导致插件找不到依赖命令。

具体修复步骤

1. 强制tmux加载Nix环境

在Home-manager的tmux配置中注入Nix环境变量，确保tmux能找到Nix管理的工具：

programs.tmux.extraConfig = ''
  # 加载用户级Nix环境路径
  source-file ~/.nix-profile/etc/profile.d/nix.sh
  # 若使用nix-darwin，追加系统级Nix路径
  set-environment -g PATH "/run/current-system/sw/bin:$PATH"
'';

2. 通过Nix包管理器安装tmux插件

放弃手动安装插件，直接用Home-manager的插件管理功能，它会自动处理插件的路径和依赖：

programs.tmux.plugins = with pkgs.tmuxPlugins; [
  sensible
  catppuccin
  # 添加你需要的其他插件
];

3. 指定tmux默认shell为Nix管理的bash

部分插件脚本依赖新版bash，macOS默认bash版本老旧且路径不符，可在配置中指定：

programs.tmux.defaultShell = "${pkgs.bash}/bin/bash";

4. 验证环境变量

启动tmux后执行echo $PATH，对比手动终端的echo $PATH，确认包含~/.nix-profile/bin、/run/current-system/sw/bin等Nix相关路径。

完整配置示例

{ pkgs, ... }:

{
  programs.tmux = {
    enable = true;
    defaultShell = "${pkgs.bash}/bin/bash";
    plugins = with pkgs.tmuxPlugins; [
      sensible
      catppuccin
    ];
    extraConfig = ''
      source-file ~/.nix-profile/etc/profile.d/nix.sh
      # 自定义tmux配置
      set -g status-interval 2
      set -g mouse on
    '';
  };
}