mac上成功配置tmux需四步：一、用homebrew安装（推荐）；二、无homebrew时手动编译；三、配置鼠标支持与前缀键优化；四、验证会话持久化。
如果您希望在Mac上使用Tmux实现终端复用、会话持久化及多任务并行操作，但尚未安装或配置成功，则可能是由于Homebrew未就绪、依赖缺失或配置未生效。以下是解决此问题的步骤：
一、通过Homebrew安装Tmux
Homebrew是Mac最主流的包管理器，能自动处理libevent等必要依赖，并保持版本更新。该方法适用于macOS 12及以上系统，且已安装Xcode Command Line Tools。
1、打开终端，执行命令安装Homebrew（若尚未安装）：
ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/head/install.sh)"
2、安装完成后，运行以下命令更新brew源并安装tmux：
brew update && brew install tmux
3、验证安装是否成功：
tmux -V
4、确认输出类似tmux 3.4即表示安装完成。
二、手动编译安装（无Homebrew环境时）
当无法使用Homebrew（如受限网络、企业策略禁止）时，可从源码编译安装。此方式需手动满足libevent和ncurses依赖，适合高级用户或定制化部署场景。
1、先安装必要依赖（使用MacPorts）：
sudo port install libevent +universal ncurses +universal
2、下载最新稳定版源码（以3.4为例）：
curl -O https://github.com/tmux/tmux/releases/download/3.4/tmux-3.4.tar.gz
3、解压并进入目录：
tar -xzf tmux-3.4.tar.gz && cd tmux-3.4
4、配置、编译并安装：
./configure && make && sudo make install
5、检查二进制路径是否在$PATH中：
which tmux
若返回/usr/local/bin/tmux或类似路径，则安装就绪。
三、启用鼠标支持与前缀键优化
Tmux默认使用Ctrl+b作为前缀键且禁用鼠标，不符合现代操作直觉。通过修改配置文件可提升交互效率，避免频繁记忆快捷键组合。
1、创建或编辑配置文件：
touch ~/.tmux.conf && vim ~/.tmux.conf
2、写入以下核心配置：
set-g mouse on
unbind C-b
set-g prefix C-a
bind C-a send-prefix
3、保存退出后，在任意终端中执行：
tmux source-file ~/.tmux.conf
4、新启动的tmux会话将支持鼠标拖拽调整面板大小、点击切换窗口/面板、Ctrl+a替代Ctrl+b激活命令。
四、验证并启动首个持久化会话
安装与配置完成后，需验证会话是否真正具备断连存活能力。该步骤模拟真实远程开发中断场景，确保Tmux服务器进程持续运行。
1、启动命名会话：
tmux new-session -s dev-main
2、在该会话中运行一个持续输出的命令（如）：
while true; do date; sleep 5; done
3、按下Ctrl+a → d脱离会话（不终止）
4、关闭当前iTerm2或Terminal窗口
5、重新打开终端，执行：
tmux attach-session -t dev-main
6、确认时间输出仍在继续，且进程PID未变化、工作目录与脱离前完全一致。
