tmux 完全指南：原理、使用教程与实战场景

   你的终端 (Alacritty / iTerm / Windows Terminal / ssh)
        │  键盘输入 / 屏幕输出
        ▼
   ┌─────────────┐        Unix domain socket
   │ tmux client │◄──────────────────────────────┐
   └─────────────┘   /tmp/tmux-1000/default      │
                                                 ▼
                                    ┌────────────────────────────┐
                                    │      tmux server           │
                                    │  （常驻后台的单个进程）      │
                                    │                            │
                                    │  session: work             │
                                    │    ├── window 0: editor    │
                                    │    │     ├── pane %0 ──► nvim
                                    │    │     └── pane %1 ──► go run
                                    │    └── window 1: logs      │
                                    │          └── pane %2 ──► tail -f
                                    │  session: ops              │
                                    │    └── window 0 ──► bash   │
                                    └────────────────────────────┘

# 看进程树：server 和 client 是两个独立进程
pgrep -a tmux
# 3721 tmux: server
# 8899 tmux attach

# socket 就是一个文件
ls -l /tmp/tmux-$(id -u)/
# srwxrwx--- 1 zhxu zhxu 0 Jul 30 08:39 default

# 用不同 socket 起一套完全独立的 tmux（互不可见）
tmux -L test new -s foo

        ┌───────────────── tmux server ─────────────────┐
        │                                               │
 client │   pty master  ◄────► [ 终端仿真 + grid 缓冲 ]  │
 ◄──────┼───────────────┐                               │
        │               │                               │
        └───────────────┼───────────────────────────────┘
                        │
                  pty slave (/dev/pts/7)
                        │ 作为控制终端
                        ▼
                  bash ──► go run ./main.go

pane 的内存结构（简化）
├── 可见屏幕：80×24 的字符网格，每格存 字符 + 前景色 + 背景色 + 属性(粗体/下划线…)
├── scrollback 历史：向上滚动的行，上限由 history-limit 决定（默认仅 2000 行）
└── 终端状态机：光标位置、当前 SGR 属性、备用屏幕(alternate screen)、模式标志…

session（会话）  ── 一个工作上下文，attach/detach 的单位，独立于任何终端
  └── window（窗口） ── 相当于"标签页"，占满整个可见区域，同一时刻只显示一个
        └── pane（窗格） ── 窗口内的矩形分割，每个 pane 一个 pty + 一个进程

tmux list-keys -T prefix     # 看前缀键表里所有绑定
tmux list-keys -T root       # 看直接生效的绑定（鼠标绑定都在这里）

真终端 (支持真彩色、OSC 52、图片协议…)
   ▲ tmux 按 外层 TERM 的能力输出
   │
 tmux server ── 内部维护 grid
   │ 向 pane 内程序宣告能力：TERM=tmux-256color
   ▼
 nvim / htop / less

# 这三者执行的是同一个东西
# ① 按键：C-b %
# ② tmux 命令提示符（C-b :）里输入：split-window -h
# ③ shell 里：
tmux split-window -h

# Debian / Ubuntu
sudo apt install tmux
# Arch
sudo pacman -S tmux
# macOS
brew install tmux
# CentOS / RHEL
sudo yum install tmux

tmux -V   # 确认版本，3.x 以上默认值更合理

tmux                      # 开一个匿名会话（不推荐，名字是 0、1、2…）
tmux new -s work          # ✅ 开一个叫 work 的会话
# ……干活……
# 按 C-b d 脱离（detach），任务继续跑

tmux ls                   # 看有哪些会话
# work: 2 windows (created Thu Jul 30 09:00:20 2026)

tmux attach -t work       # 重新接回来（可简写 tmux a -t work）
tmux kill-session -t work # 确认不要了再关

tmux new -A -s work   # 存在就 attach，不存在就创建（-A = attach if exists）

alias w='tmux new -A -s work'

tmux ls                            # list-sessions
tmux new -s name -d                # 后台创建，不 attach
tmux new -A -s name                # 有则 attach，无则创建
tmux attach -t name                # attach
tmux attach -d -t name             # attach 并把其他客户端踢掉（-d = detach others）
tmux attach -r -t name             # 只读 attach（read-only，演示/围观用）
tmux rename-session -t old new
tmux kill-session -t name
tmux has-session -t name 2>/dev/null && echo exists   # 脚本里做判断

# 把 3 号窗口的 pane 拉到当前窗口，左右并排
tmux join-pane -h -s 3
# 把当前 pane 送到 logs 窗口
tmux join-pane -t logs
# 把 pane 独立成窗口
tmux break-pane

# 路线 A：OSC 52（推荐，跨 SSH 也能用，前提是外层终端支持）
set -s set-clipboard on

# 路线 B：管到本机剪贴板程序（copy-pipe）
# Linux/X11:
bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel 'xclip -selection clipboard -i'
# Wayland:
bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel 'wl-copy'
# macOS:
bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel 'pbcopy'

tmux show-buffer                      # 打印当前 buffer
tmux save-buffer out.txt              # 存文件
tmux load-buffer <(pbpaste)           # 从外部灌进 tmux buffer
tmux set-buffer "hello"               # 直接塞内容

# ============ 基础手感 ============
# 前缀键改成 C-a（更好按；代价是和 shell 的行首快捷键冲突，
# 所以再绑一个 C-a C-a 把真正的 C-a 送进去）
set -g prefix C-a
unbind C-b
bind C-a send-prefix

# 窗口/窗格从 1 开始编号，关掉窗口后自动重排序号
set -g base-index 1
setw -g pane-base-index 1
set -g renumber-windows on

# scrollback 默认只有 2000 行，太小
set -g history-limit 50000

# 开鼠标：滚轮翻历史、点击切 pane、拖边框调大小
set -g mouse on

# vi 风格的复制模式（默认是 emacs）
setw -g mode-keys vi
bind -T copy-mode-vi v send-keys -X begin-selection
bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel 'wl-copy'   # 按系统替换
set -s set-clipboard on          # 走 OSC 52，跨 SSH 也能复制到本机

# ESC 键延迟：3.x 默认已是 10ms，老版本是 500ms（会让 vim 的 ESC 发木）
set -s escape-time 10

# 让 vim 的 FocusGained/autoread 生效
set -g focus-events on

# ============ 颜色与终端能力 ============
set -g default-terminal "tmux-256color"
# 向外层真终端声明真彩色能力（把 xterm-256color 换成你外层实际的 TERM）
set -as terminal-features ",xterm-256color:RGB"

# ============ 更顺手的绑定 ============
# 分屏用 | 和 -（形状即所见），并继承当前目录
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"
unbind '"'
unbind %
# 新窗口也继承当前目录
bind c new-window -c "#{pane_current_path}"

# 无前缀切 pane（Alt+方向键）
bind -n M-Left  select-pane -L
bind -n M-Right select-pane -R
bind -n M-Up    select-pane -U
bind -n M-Down  select-pane -D

# 一键重载配置
bind R source-file ~/.tmux.conf \; display-message "tmux.conf reloaded"

# 同步输入到所有 pane（批量操作多台机器时开/关）
bind S setw synchronize-panes \; display-message "sync #{?pane_synchronized,ON,OFF}"

# 弹出层里开一个临时 shell（scratch），再按一次关掉
bind g display-popup -E -w 80% -h 80% -d "#{pane_current_path}"

# ============ 状态栏 ============
set -g status-position top
set -g status-interval 5
set -g status-left  " #[bold]#S #[default]"
set -g status-right " #{?pane_synchronized,#[reverse] SYNC #[default] ,}%Y-%m-%d %H:%M "
setw -g automatic-rename on

ssh server
tmux new -A -s migrate
./long_migration.sh        # 跑起来
# C-b d 脱离，直接关笔记本回家

# 第二天，换台机器
ssh server
tmux a -t migrate          # 画面、滚动历史、进度条全都在

┌──────────────────────┬──────────────┐
│                      │  go run .    │
│        nvim          ├──────────────┤
│                      │  tail -f log │
└──────────────────────┴──────────────┘

#!/usr/bin/env bash
set -euo pipefail

SESSION="dev"
ROOT="$HOME/GolandProjects/lee"

# 已存在就直接接进去，不重复创建
if tmux has-session -t "$SESSION" 2>/dev/null; then
  exec tmux attach -t "$SESSION"
fi

# 后台创建会话和第一个窗口
tmux new-session -d -s "$SESSION" -c "$ROOT" -n editor
tmux send-keys   -t "$SESSION:editor" 'nvim .' C-m

# 第二个窗口：上下两个 pane，一个跑服务一个跑日志
tmux new-window  -t "$SESSION" -c "$ROOT" -n server
tmux send-keys   -t "$SESSION:server" 'hugo server -D' C-m
tmux split-window -t "$SESSION:server" -v -c "$ROOT"
tmux send-keys   -t "$SESSION:server.2" 'git status' C-m

# 第三个窗口：留个干净 shell
tmux new-window  -t "$SESSION" -c "$ROOT" -n shell

tmux select-window -t "$SESSION:editor"
exec tmux attach -t "$SESSION"

tmux new -d -s tmp 'top' \; split-window -d 'htop' \; attach

# 向某个 pane 敲键盘（C-m = 回车）
tmux send-keys -t dev:server.1 'make build' C-m

# 抓取 pane 当前屏幕内容（-p 打到 stdout，-S -100 含最近 100 行历史）
tmux capture-pane -p -t dev:server.1 -S -100 | tail -20

# 轮询等某个关键字出现（简易"等服务起好"）
until tmux capture-pane -p -t dev:server.1 | grep -q 'Listening on'; do sleep 1; done

# 把某个 pane 的输出实时落盘（开关式）
tmux pipe-pane -t dev:server.1 -o 'cat >> /tmp/server.log'

# 读取结构化信息，写监控脚本很好用
tmux list-panes -a -F '#{session_name}:#{window_index}.#{pane_index} #{pane_current_command} #{pane_pid}'

# 四个 pane 分别 ssh 到四台机器
tmux new -s fleet \; \
  send-keys 'ssh web1' C-m \; \
  split-window -h 'ssh web2' \; \
  split-window -v 'ssh web3' \; \
  select-pane -t 1 \; split-window -v 'ssh web4' \; \
  select-layout tiled

# 打开输入同步：敲一次，所有 pane 一起执行
# C-b : setw synchronize-panes on     （或用 4.1 里绑的 C-b S）

# 方式一：同一用户、多个终端 attach 同一会话（最简单）
tmux a -t work           # 两边都看到同样画面，鼠标/键盘都能操作
tmux a -r -t work        # 围观者用只读模式，防手滑

# 方式二：两人各看各的窗口，但共享同一批窗口（会话组）
tmux new-session -t work -s work-guest

# 方式三：不同用户共享（需要放开 socket 权限，注意安全边界）
tmux -S /tmp/pair new -s pair
chmod 1777 /tmp/pair     # 另一用户: tmux -S /tmp/pair attach
tmux server-access -w otheruser   # 3.3+ 显式授权写权限

tmux new -s watch -d 'journalctl -f -u caddy'
tmux split-window -t watch -v 'journalctl -f -u artalk'
tmux split-window -t watch -h 'htop'
tmux select-layout -t watch tiled
tmux a -t watch

# 临时窗口，退出即销毁（-E），不打乱现有布局
tmux display-popup -E -w 80% -h 80% -d "#{pane_current_path}"

# 弹出层里跑单个命令
tmux display-popup -E -w 70% -h 70% 'lazygit'

会话   tmux new -A -s name   开/接会话       C-b d   脱离
       tmux ls               列会话          C-b s   选会话
       tmux a -t name        接会话          C-b $   改名

窗口   C-b c 新建   C-b , 改名   C-b n/p 切换   C-b 1..9 跳转
       C-b w 窗口树 C-b f 搜索   C-b & 关闭

窗格   C-b % 左右分  C-b " 上下分  C-b 方向键 切换  C-b z 放大
       C-b x 关闭    C-b Space 换布局   C-b C-方向键 调大小
       C-b ! 独立成窗口   C-b q 显示编号

复制   C-b [ 进入   / 搜索   Space/v 选   y 复制   C-b ] 粘贴

万能   C-b :  命令行     C-b ?  所有绑定    C-b ~  错误日志