tmux鼠标滚轮滚动历史需进入复制模式，仅set -g mouse on不足；应配set -g mouse on、history-limit 50000及terminal-overrides禁用备用屏幕。
tmux 鼠标滚轮滚动历史输出的生效条件
直接加 set -g mouse on 不一定管用，尤其在旧版 tmux 或某些终端（如 VS Code 内置终端、GNOME Terminal 旧版本）里，滚轮可能仍只控制终端 viewport，而非 tmux pane 的历史缓冲区。根本原因是：tmux 必须进入复制模式（copy mode）才能读取历史行，而鼠标滚轮本身不自动触发该模式——除非配置了条件跳转逻辑。
tmux ≥ 2.1 版本的标准配置写法
确认版本：tmux -V。若输出类似 tmux 3.2a 或 tmux 2.9a，用以下三行即可覆盖全部鼠标行为（选中窗格、拖拽调整大小、滚轮滚动历史）：
set -g mouse on-
set -g history-limit 50000（避免默认 2000 行太短，滚几下就到底） -
set -g terminal-overrides 'xterm*:smcup@:rmcup@'（禁用“备用屏幕”切换，防止某些终端劫持滚轮）
保存后，在任意 tmux 会话中执行：Prefix + :source-file ~/.tmux.conf，无需重启会话。
tmux
比如 CentOS 7 自带的 tmux 1.8，mouse on 无效，必须逐项启用：
-
setw -g mode-mouse on（关键：让滚轮在非复制模式下也能触发 copy mode） setw -g mouse-select-pane onsetw -g mouse-select-window onsetw -g mouse-resize-pane on
注意：mode-mouse 是旧版唯一能实现“滚轮即滚动历史”的选项；漏掉它，滚轮只会切窗格或没反应。
VS Code / GNOME Terminal 等环境常见失效原因
即使配置正确，仍无法滚轮滚动，大概率是终端模拟器未透传鼠标事件：
- VS Code：检查设置中
terminal.integrated.sendKeybindingsToShell是否为true；若为false，tmux 根本收不到滚轮事件 - GNOME Terminal：需开启“启用鼠标报告”（Edit → Preferences → Profiles → Compatibility → Enable mouse reporting）
- Alacritty / Kitty：默认支持，但若配置了
mouse.enabled: false，需设为true
验证是否生效：进 tmux 后按 Prefix + [ 进入复制模式，此时再滚轮必然响应——如果这步都无效，说明是终端层拦截，不是 tmux 配置问题。
最易被忽略的一点：history-limit 是全局设置，但如果你用 new-session 创建新会话时指定了 -h 参数（如 tmux new-session -h 1000），它会覆盖配置文件里的 history-limit，导致滚轮很快触底。这种显式参数优先级高于配置文件，调试时得一并检查。
