Windows 环境下 Git Bash 安装 tmux 与 Fish Shell 配置教程

解决方法：

1. 退出当前会话（推荐）：在 tmux 窗口中输入 exit 并回车，回到原生终端界面，再重新启动 tmux。
2. 强制嵌套（不推荐）：如果有特殊需求必须嵌套，可以临时取消 $TMUX 变量后启动：

   unset TMUX && tmux.exe
   

   ⚠️ 注意：嵌套会话会导致快捷键、窗格管理混乱，非必要不建议这么做。

配置文件语法错误

如果遇到 [server exited unexpectedly] 或 usage: send-keys ... 错误，通常是因为 .tmux.conf 配置文件里的命令写法不合法。

常见错误示例 & 修正方案：

修复步骤：

1. 编辑配置文件：

   vim ~/.tmux.conf
   

2. 检查所有包含 send-keys 的行，确保格式为 send-keys [参数] 要发送的内容。
3. 保存配置后，杀掉可能崩溃的 tmux 进程并重新加载：

   tmux kill-server
   tmux source ~/.tmux.conf
   tmux.exe
   

Windows 环境安装指南

前置条件

首先保证已安装有 Git for Windows。

下载地址：https://git-scm.com/download/win

安装步骤

1. 下载 tmux_for_git-bash.zip 安装包。
2. 释放文件到 Git 安装目录下的 usr 文件夹（例如 D:\Git\usr）。默认路径通常是 C:\Program Files\Git\usr。
3. 实际可执行文件位于 D:\Git\usr\bin\tmux.exe。

命令行安装

也可以在 git-bash 环境下直接克隆源码包解压：

git clone https://github.com/hongwenjun/tmux_for_windows.git
cd tmux_for_windows/
unzip -x tmux_for_git-bash.zip -d /usr

使用方式

• Windows 开始菜单运行 D:\Git\git-bash.exe
• 命令行输入 tmux

Fish Shell 集成

Fish 是 "the friendly interactive shell" 的简称，最大特点就是方便易用。很多其他 Shell 需要配置才有的功能，Fish 默认提供。

安装 Fish for Git Bash

1. 下载 fish_for_git-bash.7z。
2. 释放文件到 D:\Git。
3. 实际可执行文件在 D:\Git\usr\bin\fish.exe。

把 fish 设为交互式 shell

如果不将 fish 设为默认 shell，就能照常运行 Bash 的初始化脚本。这能够保证用户当前的环境变量不受影响并且在 fish 中也能使用。

方法一：通过 .bashrc 启动 fish 保持默认 shell 为 Bash 不变，然后添加一行 exec fish 到合适的 Bash 配置文件中，比如 .bashrc。

方法二：使用终端复用器的选项 要将 fish 设为 tmux 启动的默认 shell，在 ~/.tmux.conf 中加入这行：

set-option -g default-shell "/usr/bin/fish"

关闭问候语 默认情况下，每次启动 fish，fish 都会打印问候语。要关闭问候语，可以在 fish 中运行：

set -U fish_greeting

配置优化建议

如果服务器上没有 tmux，先安装：

# Ubuntu/Debian
sudo apt update && sudo apt install tmux -y
# CentOS/RHEL
sudo yum install tmux -y

建议把 tmux 配置得更舒服一点（~/.tmux.conf），常见优化如下：

# 改前缀键为 Ctrl+a（很多人觉得比 Ctrl+b 好按）
set -g prefix C-a
unbind C-b
bind C-a send-prefix

# 鼠标支持（可选）
set -g mouse on

# 窗口从 1 开始编号（更直观）
set -g base-index 1
setw -g pane-base-index 1

# 启用鼠标操作及滚轮滚动
setw -g mouse on
set-option -g history-limit 20000
bind -n WheelUpPane select-pane -t=; copy-mode -e; send-keys -M
bind -n WheelDownPane select-pane -t=; send-keys -M

总结

tmux 就是为'SSH 掉线后还能连回原来的程序'而生的，用起来非常稳。只要你先 tmux new -s xxx 再跑训练，掉线后再 tmux a -t xxx 就能无缝接上。强烈建议你现在就试一次。