Tmux 终端复用器完全指南：从安装到自定义配置 | 2026 最新实践

1
# Ubuntu / Debian
2
sudo apt update && sudo apt install tmux
3

4
# CentOS / RHEL / Fedora
5
sudo yum install tmux        # CentOS 7
6
sudo dnf install tmux        # Fedora / CentOS 8+
7

8
# macOS（推荐 Homebrew）
9
brew install tmux
10

11
# Arch Linux
12
sudo pacman -S tmux
13

14
# Windows（通过 WSL）
15
# 先安装 WSL，然后在 WSL 内安装 tmux
16
wsl --install -d Ubuntu
17
# 进入 WSL 后：
18
sudo apt install tmux

1
# 检查版本（建议 3.2+）
2
tmux -V
3
# tmux 3.4
4

5
# 查看帮助
6
tmux list-commands | head -20

1
# 安装依赖
2
sudo apt install build-essential libevent-dev libncurses-dev
3

4
# 下载源码
5
git clone https://github.com/tmux/tmux.git
6
cd tmux
7

8
# 编译安装
9
sh autogen.sh
10
./configure
11
make -j$(nproc)
12
sudo make install
13

14
# 验证
15
/usr/local/bin/tmux -V

1
# 创建匿名会话（自动命名为 0, 1, 2...）
2
tmux
3

4
# 创建命名会话（推荐！方便管理）
5
tmux new -s myproject
6

7
# 创建会话并指定窗口名
8
tmux new -s deploy -n staging
9

10
# 在后台创建会话（不进入）
11
tmux new -s background -d

1
# 分离会话（不关闭，后台运行）
2
# 方法一：前缀键 + d
3
# Ctrl+B 然后按 d
4

5
# 方法二：命令行
6
tmux detach
7

8
# 查看所有会话
9
tmux ls
10
# myproject: 2 windows (created Sat Jul  4 10:00:00 2026) (attached)
11
# deploy: 1 windows (created Sat Jul  4 11:30:00 2026)
12

13
# 恢复（连接）最近的会话
14
tmux attach
15
# 或简写：
16
tmux a
17

18
# 恢复指定会话
19
tmux attach -t myproject
20
tmux a -t deploy
21

22
# 如果会话已被其他客户端连接，强制分离后恢复
23
tmux attach -d -t myproject
24

25
# 恢复会话并切换到指定窗口
26
tmux attach -t myproject:2

1
# 在 Tmux 内部执行命令（前缀键 + : 然后输入命令）
2
# Ctrl+B 然后按 : 然后输入：
3
new-session -s newsession       # 创建新会话
4
rename-session newname           # 重命名当前会话
5
kill-session -t oldsession       # 关闭指定会话
6

7
# 从命令行操作
8
# 重命名会话
9
tmux rename-session -t oldname newname
10

11
# 关闭指定会话
12
tmux kill-session -t deploy
13

14
# 关闭所有会话
15
tmux kill-server
16

17
# 切换会话（前缀键 + s 显示会话列表）
18
# Ctrl+B 然后按 s
19
# 使用上下键选择，回车切换

1
# 在 ~/.bashrc 或 ~/.zshrc 中添加别名
2
alias tn='tmux new -s'           # tn myproject
3
alias ta='tmux attach -t'        # ta myproject
4
alias tl='tmux ls'               # tl
5
alias tk='tmux kill-session -t'  # tk myproject
6

7
# 使用效果：
8
tn deploy        # 创建名为 deploy 的会话
9
# ...工作...
10
# Ctrl+B d 分离
11
ta deploy        # 恢复 deploy 会话
12
tl               # 查看所有会话
13
tk deploy        # 关闭 deploy 会话

1
# 创建新窗口
2
# Ctrl+B 然后按 c
3

4
# 创建窗口并命名
5
# Ctrl+B 然后按 , （逗号）修改当前窗口名
6

7
# 切换到下一个窗口
8
# Ctrl+B 然后按 n
9

10
# 切换到上一个窗口
11
# Ctrl+B 然后按 p
12

13
# 按编号切换窗口
14
# Ctrl+B 然后按 0/1/2/3...
15

16
# 列出所有窗口并选择
17
# Ctrl+B 然后按 w

1
# 重命名当前窗口
2
# Ctrl+B 然后按 ,
3

4
# 关闭当前窗口
5
# Ctrl+B 然后按 & （确认后关闭）
6

7
# 从命令行创建窗口到指定会话
8
tmux new-window -t myproject -n logs
9

10
# 从命令行切换窗口
11
tmux select-window -t myproject:2
12

13
# 从命令行关闭窗口
14
tmux kill-window -t myproject:2

1
# 水平分割（上下分割，一条水平线）
2
# Ctrl+B 然后按 "
3
# 记忆：双引号 " 在键盘上和单引号 ' 在一起，横线 ─ 是水平的
4

5
# 垂直分割（左右分割，一条垂直线）
6
# Ctrl+B 然后按 %
7
# 记忆：% 在键盘上是 Shift+5，竖线 | 是垂直的
8

9
# 等价命令行：
10
tmux split-window -h    # 水平分割（-h = horizontal split = 左右分割）
11
tmux split-window -v    # 垂直分割（-v = vertical split = 上下分割）
12
# ⚠️ 注意：Tmux 的 -h/-v 命名与直觉相反！
13
# -h = horizontal split = 创建水平分割线 = 左右两个窗格
14
# -v = vertical split = 创建垂直分割线 = 上下两个窗格

1
# 按方向切换
2
# Ctrl+B 然后按 方向键 ↑↓←→
3

4
# 顺序切换（在多个窗格间循环）
5
# Ctrl+B 然后按 o
6

7
# 显示窗格编号，按数字切换
8
# Ctrl+B 然后按 q
9
# 窗格上会短暂显示编号（0, 1, 2, 3）
10
# 在编号消失前按对应数字即可切换
11

12
# 切换到上一个活动窗格
13
# Ctrl+B 然后按 ;

1
# 方法一：方向键调整（需要按住前缀键不放）
2
# Ctrl+B（按住不放）然后按 方向键 ↑↓←→
3
# 每按一次方向键移动 1 格
4

5
# 方法二：命令行精确调整
6
tmux resize-pane -L 10    # 向左移动 10 格（L = Left）
7
tmux resize-pane -R 10    # 向右移动 10 格（R = Right）
8
tmux resize-pane -U 5     # 向上移动 5 格（U = Up）
9
tmux resize-pane -D 5     # 向下移动 5 格（D = Down）
10

11
# 方法三：在 .tmux.conf 中绑定快捷键（推荐）
12
# 见第 8 节配置部分

1
# 关闭当前窗格
2
# Ctrl+B 然后按 x （确认后关闭）
3

4
# 将当前窗格拆分为独立窗口
5
# Ctrl+B 然后按 !
6
# 窗格变成新的窗口
7

8
# 在新窗口中打开当前窗格（保留原窗格）
9
# Ctrl+B 然后按 z（再按一次恢复）
10
# 最大化/还原当前窗格（Zen 模式）
11

12
# 交换窗格位置
13
# Ctrl+B 然后按 { （与上一个窗格交换）
14
# Ctrl+B 然后按 } （与下一个窗格交换）
15

16
# 旋转所有窗格（改变布局方向）
17
# Ctrl+B 然后按 Space（空格键）
18
# 在多种预设布局间切换

1
# 创建布局的命令序列：
2
tmux new -s dev -n editor
3
# Ctrl+B % （左右分割）
4
# Ctrl+B ← （切到左边的窗格）
5
# Ctrl+B " （上下分割左边）
6
# Ctrl+B ↑ （切到上方 = 编辑器）
7
# Ctrl+B → （切到右边）
8
# Ctrl+B " （上下分割右边）
9
# 调整大小...

1
# 进入复制模式
2
# Ctrl+B 然后按 [
3

4
# 进入后左上角会显示 [copy]
5
# 此时光标可以自由移动（vi 模式用 hjkl，emacs 模式用 Ctrl+F/B）

1
# 1. 进入复制模式：Ctrl+B [
2
# 2. 移动光标到起始位置
3
# 3. 按 Space 开始选择
4
# 4. 移动光标到结束位置
5
# 5. 按 Enter 复制
6

7
# 粘贴
8
# Ctrl+B 然后按 ]
9

10
# 查看复制缓冲区列表
11
# Ctrl+B 然后按 # （或 = 显示缓冲区列表选择）
12

13
# 从命令行操作
14
tmux list-buffers          # 查看所有缓冲区
15
tmux show-buffer           # 查看最新缓冲区内容
16
tmux save-buffer file.txt  # 保存缓冲区到文件
17
tmux load-buffer file.txt  # 从文件加载到缓冲区

1
# macOS：使用 pbcopy/pbpaste
2
# 在 .tmux.conf 中添加：
3
set -g default-command "reattach-to-user-namespace -l ${SHELL}"
4
# 或使用 tmux-macos-copy 插件
5

6
# Linux：使用 xclip
7
bind-key -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "xclip -selection clipboard"
8

9
# Linux（Wayland）：使用 wl-copy
10
bind-key -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "wl-copy"
11

12
# macOS（推荐配置）：
13
bind-key -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "pbcopy"
14
bind-key -T copy-mode-vi MouseDragEnd1Pane send-keys -X copy-pipe-and-cancel "pbcopy"

1
# 临时开启（命令模式）
2
# Ctrl+B 然后按 : 然后输入：
3
set mouse on
4

5
# 永久开启（.tmux.conf）
6
set -g mouse on

1
# 有时鼠标模式会干扰终端原生选择文本
2
# 快速切换鼠标模式：
3
# 在 .tmux.conf 中绑定快捷键：
4
bind m set -g mouse \; display-message "Mouse: #{?mouse,ON,OFF}"
5
# Ctrl+B 然后按 m 切换鼠标模式
6

7
# 按住 Shift 键可以绕过 Tmux 鼠标捕获
8
# 在大多数终端中：Shift + 鼠标拖动 = 终端原生选择

1
# ============================================
2
# Tmux 配置文件 - 2026 最佳实践
3
# ============================================
4

5
# --- 基础设置 ---
6

7
# 修改前缀键为 Ctrl+A（更顺手）
8
unbind C-b
9
set -g prefix C-a
10
bind C-a send-prefix
11

12
# 启用真彩色
13
set -g default-terminal "tmux-256color"
14
set -ag terminal-overrides ",xterm-256color:RGB,*:RGB"
15

16
# 历史记录条数
17
set -g history-limit 50000
18

19
# 窗口编号从 1 开始（0 太远了）
20
set -g base-index 1
21
setw -g pane-base-index 1
22

23
# 窗口关闭后自动重新编号
24
set -g renumber-windows on
25

26
# 减少 ESC 键延迟（避免 Vim 里按 ESC 卡顿）
27
set -sg escape-time 0
28

29
# 启用鼠标
30
set -g mouse on
31

32
# Vi 模式
33
setw -g mode-keys vi
34

35
# --- 快捷键 ---
36

37
# 重新加载配置
38
bind r source-file ~/.tmux.conf \; display-message "Config reloaded!"
39

40
# 更直观的分割键
41
bind | split-window -h -c "#{pane_current_path}"    # | 左右分割
42
bind - split-window -v -c "#{pane_current_path}"    # - 上下分割
43
unbind '"'
44
unbind %
45

46
# 新窗口保持当前路径
47
bind c new-window -c "#{pane_current_path}"
48

49
# Vim 风格切换窗格
50
bind h select-pane -L
51
bind j select-pane -D
52
bind k select-pane -U
53
bind l select-pane -R
54

55
# Vim 风格调整窗格大小（大写 HJKL）
56
bind -r H resize-pane -L 5
57
bind -r J resize-pane -D 5
58
bind -r K resize-pane -U 5
59
bind -r L resize-pane -R 5
60

61
# 复制模式 Vim 风格
62
bind -T copy-mode-vi v send-keys -X begin-selection
63
bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "pbcopy"
64

65
# --- 状态栏 ---
66

67
set -g status-position top
68
set -g status-interval 5
69
set -g status-style "bg=default,fg=white"
70

71
# 左侧：会话名
72
set -g status-left "#[fg=black,bold] #S "
73
set -g status-left-length 30
74

75
# 右侧：日期时间
76
set -g status-right "#[fg=white] %Y-%m-%d %H:%M "
77
set -g status-right-length 30
78

79
# 窗口列表样式
80
setw -g window-status-format " #I:#W "
81
setw -g window-status-current-format "#[fg=black,bold] #I:#W "

1
# === 会话持久化 ===
2
# 自动恢复会话（需配合 tmux-resurrect 插件）
3

4
# === 主题配色 ===
5
# 深色主题
6
set -g status-bg "#1a1b26"
7
set -g status-fg "#a9b1d6"
8
set -g pane-active-border-style "fg=#7aa2f7"
9
set -g pane-border-style "fg=#3b4261"
10

11
# === 日志/监控 ===
12
# 状态栏显示 CPU/内存（需安装 tmux-cpu 插件或自定义脚本）
13
set -g status-right "CPU: #{cpu_percentage} | MEM: #{ram_percentage} | %H:%M"
14

15
# === 自动启动 ===
16
# SSH 登录时自动连接或创建会话
17
# 在 ~/.bashrc 中添加：
18
# if [ -z "$TMUX" ]; then
19
#     tmux attach -t default || tmux new -s default
20
# fi

1
# 克隆 TPM 仓库
2
git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm
3

4
# 在 .tmux.conf 末尾添加：
5
set -g @plugin 'tmux-plugins/tpm'
6

7
# 推荐插件
8
set -g @plugin 'tmux-plugins/tmux-sensible'      # 合理的默认配置
9
set -g @plugin 'tmux-plugins/tmux-resurrect'     # 会话保存与恢复
10
set -g @plugin 'tmux-plugins/tmux-continuum'     # 自动保存会话
11
set -g @plugin 'tmux-plugins/tmux-yank'          # 增强复制
12
set -g @plugin 'tmux-plugins/tmux-pain-control'  # 窗格管理增强
13

14
# 主题插件（选一个）
15
set -g @plugin 'catppuccin/tmux'                 # Catppuccin 主题
16
# set -g @plugin 'dracula/tmux'                   # Dracula 主题
17

18
# 初始化 TPM（必须在所有插件声明之后）
19
run '~/.tmux/plugins/tpm/tpm'

1
# 安装插件：
2
# 1. 保存 .tmux.conf
3
# 2. 在 Tmux 中按 Ctrl+B 然后按 I（大写 I = Install）
4
# 3. 等待安装完成后自动刷新
5

6
# 更新插件：Ctrl+B 然后按 U（大写 U = Update）
7
# 卸载插件：从 .tmux.conf 删除插件行，然后 Ctrl+B 然后按 Alt+u

1
# 安装后配置
2
set -g @plugin 'tmux-plugins/tmux-resurrect'
3

4
# 保存会话：Ctrl+B 然后按 Ctrl+s
5
# 恢复会话：Ctrl+B 然后按 Ctrl+r
6

7
# 进阶配置：保存更多程序状态
8
set -g @resurrect-capture-pane-contents 'on'    # 保存窗格内容
9
set -g @resurrect-strategy-vim 'session'        # 保存 Vim 会话
10
set -g @resurrect-processes 'ssh psql mysql sqlite3 "~git status->git status" "~tail->tail"'
11
# 指定哪些程序需要恢复
12

13
# 配合 tmux-continuum 自动保存
14
set -g @plugin 'tmux-plugins/tmux-continuum'
15
set -g @continuum-restore 'on'        # 启动时自动恢复
16
set -g @continuum-save-interval '15'  # 每 15 分钟自动保存

1
# === 第一次工作 ===
2

3
# 1. SSH 连接服务器
4
ssh user@server
5

6
# 2. 创建命名会话
7
tmux new -s project
8

9
# 3. 在会话中工作...
10
#    创建窗口、分割窗格、运行任务...
11

12
# 4. 需要离开时（不要直接关终端！）
13
#    Ctrl+B d 分离会话
14
#    会话在服务器后台继续运行
15

16
# 5. 可以直接关闭 SSH 连接
17
exit
18
# 服务器上的任务不受影响！
19

20
# === 恢复工作 ===
21

22
# 1. 重新 SSH 连接
23
ssh user@server
24

25
# 2. 恢复会话
26
tmux attach -t project
27
# 所有窗口、窗格、运行中的任务都还在！
28

29
# 3. 或者恢复最近的会话
30
tmux a

1
# 在远程服务器的 ~/.bashrc 或 ~/.zshrc 中添加：
2

3
# SSH 登录时自动连接或创建 Tmux 会话
4
if [ -z "$TMUX" ]; then
5
    # 检查是否有现有会话
6
    if tmux has-session -t default 2>/dev/null; then
7
        # 有现有会话，连接它
8
        tmux attach -t default
9
    else
10
        # 没有会话，创建新会话
11
        tmux new -s default
12
    fi
13
fi
14

15
# 更高级版本：让用户选择会话
16
if [ -z "$TMUX" ]; then
17
    sessions=$(tmux ls 2>/dev/null | wc -l)
18
    if [ "$sessions" -gt 0 ]; then
19
        tmux attach
20
    else
21
        tmux new -s default
22
    fi
23
fi

1
# 在本地 ~/.bashrc 或 ~/.zshrc 中添加：
2

3
# SSH 连接并自动 attach Tmux
4
ssh-tmux() {
5
    ssh -t "$@" "tmux attach -t default 2>/dev/null || tmux new -s default"
6
}
7

8
# 使用：
9
ssh-tmux user@server
10
ssh-tmux admin@prod-server -p 2222
11
# -t 参数分配伪终端（Tmux 需要）
12

13
# 或更简洁的别名
14
alias ssh-prod='ssh -t admin@prod.example.com "tmux a -t default || tmux new -s default"'
15
alias ssh-dev='ssh -t dev@dev.example.com "tmux a -t default || tmux new -s default"'

1
# 场景：你想让同事看到你的终端操作
2

3
# 方法一：共享现有会话
4
# 你先连接：
5
tmux new -s pair-programming
6
# 同事 SSH 连接同一服务器后：
7
tmux attach -t pair-programming
8
# 两人同时看到同一画面，都能输入！
9

10
# 方法二：只读模式（同事只能看不能操作）
11
tmux attach -t pair-programming -r
12
# -r = read-only
13

14
# 方法三：使用 tmux-fzf 快速切换
15
# 安装 tmux-fzf 后：
16
# Ctrl+B 然后按 T（大写 T）打开 fzf 选择器

1
# 场景：SSH 意外断开（网络问题），Tmux 会话仍在运行
2

3
# 1. 重新 SSH 连接
4
ssh user@server
5

6
# 2. 查看所有会话
7
tmux ls
8
# 可能会看到：
9
# default: 1 windows (created Sat Jul 4 10:00:00 2026) (attached)
10
# 注意：可能显示 (dead) 如果会话已结束
11

12
# 3. 如果有多个客户端连接（之前没分离就断开了）
13
tmux attach -d -t default
14
# -d = 先分离其他客户端再连接
15

16
# 4. 如果会话显示为 dead
17
tmux kill-session -t dead_session
18
tmux new -s default

1
# 创建预设布局的会话（一键搭建工作环境）
2
tmux new -d -s work
3
tmux new-window -t work
4
tmux split-window -h -t work
5
tmux send-keys -t work:0.0 'vim' C-m
6
tmux send-keys -t work:0.1 'tail -f /var/log/syslog' C-m
7
tmux attach -t work
8
# C-m = 回车键

1
# 赋予执行权限
2
chmod +x ~/scripts/tmux-start.sh
3

4
# 使用：
5
~/scripts/tmux-start.sh
6
# 或添加到 ~/.bashrc
7
alias dev='~/scripts/tmux-start.sh'

1
# 创建浮动窗口（弹出式终端）
2
# Ctrl+B 然后按 )
3
# 或自定义快捷键：
4
bind-key Tab if-shell -F '#{==:#{window_panes},1}' \
5
    'split-window -h -f -c "#{pane_current_path}"' \
6
    'resize-pane -Z'
7

8
# 命令行创建弹出式窗口
9
tmux display-popup -E "htop"
10
# -E = 关闭时自动退出
11
# 可用于快捷运行临时命令

1
# 使用 synchronize-panes 在多个窗格同时输入相同命令
2
# Ctrl+B 然后按 : 然后输入：
3
setw synchronize-panes on
4

5
# 现在在任何一个窗格输入的命令会同时发送到所有窗格
6
# 适用场景：在多台服务器上同时执行相同操作
7

8
# 在 .tmux.conf 中绑定快捷键
9
bind S setw synchronize-panes \; display-message "Sync: #{?pane_synchronized,ON,OFF}"
10
# Ctrl+B 然后按 S 切换同步模式
11

12
# 典型用法：
13
# 1. 创建 4 个窗格，每个 SSH 到不同服务器
14
# 2. 开启 synchronize-panes
15
# 3. 输入 sudo apt update ——4 台同时执行！
16
# 4. 关闭 synchronize-panes

1
# 在 ~/.bashrc 或 ~/.zshrc 中添加：
2

3
# 会话管理
4
alias tn='tmux new -s'
5
alias ta='tmux attach -t'
6
alias tl='tmux ls'
7
alias tk='tmux kill-session -t'
8
alias tka='tmux kill-server'
9

10
# 快捷操作
11
alias tns='tmux new -s $(basename $PWD)'  # 用当前目录名作为会话名
12

13
# 一键 attach 或 new
14
function tm() {
15
    local session=${1:-default}
16
    tmux attach -t $session 2>/dev/null || tmux new -s $session
17
}
18
# 使用：tm（创建/连接 default 会话）
19
#       tm myproject（创建/连接 myproject 会话）

1
# 窗格活动监控（有输出时状态栏高亮）
2
setw -g monitor-activity on
3
set -g visual-activity on
4

5
# 窗格内容变化铃声
6
setw -g monitor-bell on
7

8
# 自定义监控：命令完成后通知
9
# 在 .tmux.conf 中添加：
10
bind-key m run-shell "tmux split-window -h 'bash -c \"echo 等待命令完成...; read -p \\\"按回车关闭\\\"\"'"

1
# 安装 Catppuccin 主题
2
set -g @plugin 'catppuccin/tmux'
3

4
# 选择口味（Latte/Frappé/Macchiato/Mocha）
5
set -g @catppuccin_flavour 'mocha'  # 深色
6

7
# 自定义状态栏模块
8
set -g @catppuccin_window_status_style "rounded"
9

10
# 显示内容
11
set -g status-right-length 100
12
set -g status-right ""
13
set -g status-right "#{E:@catppuccin_status_application}"
14
set -ag status-right "#{E:@catppuccin_status_session}"
15
set -ag status-right "#{E:@catppuccin_status_uptime}"
16
set -ag status-right "#{E:@catppuccin_status_date_time}"

1
# === 简洁状态栏 ===
2
set -g status-position bottom
3
set -g status-justify centre
4
set -g status-interval 5
5

6
# 配色
7
set -g status-bg "#1e1e2e"
8
set -g status-fg "#cdd6f4"
9

10
# 左侧：会话名 + 窗口信息
11
set -g status-left-length 40
12
set -g status-left "#[fg=#1e1e2e,bg=#89b4fa,bold] #S #[fg=#89b4fa,bg=#1e1e2e] "
13

14
# 右侧：日期时间
15
set -g status-right-length 60
16
set -g status-right "#[fg=#a6adc8] %Y-%m-%d #[fg=#89b4fa]%H:%M "
17

18
# 当前窗口样式
19
setw -g window-status-current-format "#[fg=#1e1e2e,bg=#89b4fa,bold] #I:#W "
20
setw -g window-status-format "#[fg=#a6adc8] #I:#W "
21

22
# 窗格边框
23
set -g pane-border-style "fg=#313244"
24
set -g pane-active-border-style "fg=#89b4fa"

1
# 方法一：在 Tmux 内重新加载
2
# Ctrl+B 然后按 : 然后输入：
3
source-file ~/.tmux.conf
4

5
# 方法二：绑定快捷键（推荐在 .tmux.conf 中添加）
6
bind r source-file ~/.tmux.conf \; display-message "Config reloaded!"
7
# Ctrl+B 然后按 r 重新加载
8

9
# 方法三：完全重启 Tmux
10
tmux kill-server
11
tmux new -s default
12
# ⚠️ 这会关闭所有现有会话！
13

14
# 检查配置文件语法
15
tmux -f ~/.tmux.conf -L test new -d
16
# 如果没有报错说明语法正确
17
tmux -L test kill-server

1
# 问题：Tmux 内颜色异常或 Vim 颜色不对
2

3
# 解决：在 .tmux.conf 中设置正确的终端类型
4
set -g default-terminal "tmux-256color"
5
set -ag terminal-overrides ",xterm-256color:RGB,*:RGB"
6

7
# 在 ~/.bashrc 中也设置
8
export TERM=tmux-256color
9

10
# 如果使用 Vim/Neovim，确保配置中支持真彩色
11
# Neovim init.lua:
12
vim.o.termguicolors = true
13

14
# Vim .vimrc:
15
set termguicolors

1
# 问题：在 Tmux 内使用 Vim 时，按 ESC 后有明显延迟
2

3
# 原因：Tmux 默认 escape-time 为 500ms
4
# 解决：在 .tmux.conf 中设置
5
set -sg escape-time 0
6
# 或设为很小的值
7
set -sg escape-time 10

1
# macOS：安装 reattach-to-user-namespace
2
brew install reattach-to-user-namespace
3
# 在 .tmux.conf 中：
4
set -g default-command "reattach-to-user-namespace -l $SHELL"
5

6
# Linux（X11）：安装 xclip
7
sudo apt install xclip
8
# 在 .tmux.conf 中：
9
bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "xclip -selection clipboard"
10

11
# Linux（Wayland）：安装 wl-clipboard
12
sudo apt install wl-clipboard
13
# 在 .tmux.conf 中：
14
bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "wl-copy"
15

16
# 或直接使用 tmux-yank 插件（自动适配）
17
set -g @plugin 'tmux-plugins/tmux-yank'

1
# 方法一：按住 Shift 键选择（绕过 Tmux 鼠标捕获）
2
Shift + 鼠标拖动
3

4
# 方法二：临时关闭鼠标模式
5
# Ctrl+B 然后按 : 输入：
6
set mouse off
7

8
# 方法三：绑定快捷键切换
9
bind m set -g mouse \; display-message "Mouse: #{?mouse,ON,OFF}"

1
# 问题：新窗口/窗格不在当前目录
2

3
# 解决：在 .tmux.conf 中确保使用 pane_current_path
4
bind c new-window -c "#{pane_current_path}"
5
bind | split-window -h -c "#{pane_current_path}"
6
bind - split-window -v -c "#{pane_current_path}"

1
# ============================================
2
# Tmux 配置 - 2026 完整版
3
# 作者: 971918.xyz
4
# ============================================
5

6
# --- 基础设置 ---
7
unbind C-b
8
set -g prefix C-a
9
bind C-a send-prefix
10

11
set -g default-terminal "tmux-256color"
12
set -ag terminal-overrides ",xterm-256color:RGB,*:RGB"
13
set -g history-limit 50000
14
set -g base-index 1
15
setw -g pane-base-index 1
16
set -g renumber-windows on
17
set -sg escape-time 0
18
set -g mouse on
19
setw -g mode-keys vi
20
set -g focus-events on
21

22
# --- 快捷键 ---
23
bind r source-file ~/.tmux.conf \; display-message "✅ Config reloaded!"
24

25
# 窗格分割
26
bind | split-window -h -c "#{pane_current_path}"
27
bind - split-window -v -c "#{pane_current_path}"
28

29
# 新窗口保持路径
30
bind c new-window -c "#{pane_current_path}"
31

32
# Vim 风格窗格切换
33
bind h select-pane -L
34
bind j select-pane -D
35
bind k select-pane -U
36
bind l select-pane -R
37

38
# Vim 风格调整大小
39
bind -r H resize-pane -L 5
40
bind -r J resize-pane -D 5
41
bind -r K resize-pane -U 5
42
bind -r L resize-pane -R 5
43

44
# 复制模式
45
bind -T copy-mode-vi v send-keys -X begin-selection
46
bind -T copy-mode-vi y send-keys -X copy-pipe-and-cancel "pbcopy"
47

48
# 同步输入切换
49
bind S setw synchronize-panes \; display-message "Sync: #{?synchronize-panes,ON,OFF}"
50

51
# 鼠标切换
52
bind m set -g mouse \; display-message "Mouse: #{?mouse,ON,OFF}"
53

54
# --- 状态栏 ---
55
set -g status-position top
56
set -g status-interval 5
57
set -g status-style "bg=#1e1e2e,fg=#cdd6f4"
58

59
set -g status-left "#[fg=#1e1e2e,bg=#89b4fa,bold] #S #[default]"
60
set -g status-left-length 30
61

62
set -g status-right "#[fg=#a6adc8] %Y-%m-%d #[fg=#89b4fa]%H:%M "
63
set -g status-right-length 50
64

65
setw -g window-status-format "#[fg=#a6adc8] #I:#W "
66
setw -g window-status-current-format "#[fg=#1e1e2e,bg=#89b4fa,bold] #I:#W "
67

68
set -g pane-border-style "fg=#313244"
69
set -g pane-active-border-style "fg=#89b4fa"
70

71
# --- 监控 ---
72
setw -g monitor-activity on
73
set -g visual-activity off
74

75
# --- 插件 ---
76
set -g @plugin 'tmux-plugins/tpm'
77
set -g @plugin 'tmux-plugins/tmux-sensible'
78
set -g @plugin 'tmux-plugins/tmux-resurrect'
79
set -g @plugin 'tmux-plugins/tmux-continuum'
80
set -g @plugin 'tmux-plugins/tmux-yank'
81

82
set -g @resurrect-capture-pane-contents 'on'
83
set -g @continuum-restore 'on'
84
set -g @continuum-save-interval '15'
85

86
run '~/.tmux/plugins/tpm/tpm'

1
tmux                          # 创建匿名会话
2
tmux new -s name              # 创建命名会话
3
tmux ls                       # 列出所有会话
4
tmux a                        # 连接最近会话
5
tmux a -t name                # 连接指定会话
6
tmux a -d -t name             # 分离其他客户端后连接
7
tmux kill-session -t name     # 关闭指定会话
8
tmux kill-server              # 关闭所有会话
9
tmux source ~/.tmux.conf      # 重新加载配置