说实话这标题一看就是自己写着用的水贴但我还真觉得这个需求值得好好展开聊聊。tmux用户应该都有过这种经历跑了半天的日志输出、某个命令打印的一大屏结果、或者调试时终端里滚过去的报错信息想复制下来发给别人结果鼠标一拖要么拖歪了要么复制进来全是乱的对齐空格要么干脆选不中。窗口内容太长的时候拖选简直是一场灾难。我自己常年开 tmux好几个窗格同时挂服务、看日志、跑脚本隔三差五就得把某个窗格的内容整段导出来。一开始也是鼠标选中然后 CtrlShiftC后来发现很多时候根本选不全、选不对尤其是窗格里有颜色控制符、有长行折行的时候复制出来就是一团浆糊。后来我试了 tmux 自带的 capture-pane、copy-mode 全选再配合系统剪切板工具才算彻底解决了这个痛点。这篇文章就把我自己沉淀下来的一套方案完整写出来从原理到实操从输出到文件到直接进本地剪切板从 Linux 到 macOS 再到 Windows 下的 WSL 场景全部覆盖。不管你是刚用 tmux 的新手还是天天泡在终端里的老油条这几种方法都值得留在你的配置里。1. 先把需求拆清楚为什么“全选复制”在 tmux 里这么难1.1 你要复制的到底是什么内容先明确一个问题当你说“把 tmux 窗格内容全选”你面对的其实不只是当前屏幕上显示的那一屏内容。更多时候你要复制的是从这个窗格创建以来、已经滚上去的历史内容或者是一个命令输出特别长、早就超过了一屏的结果。tmux 的窗格内部有一套自己的回滚缓冲区类似终端的 scrollback凡是打印过但已经滚出屏幕的内容都存在这个缓冲区里。普通终端里你可以用鼠标滚轮往上翻然后拖选但 tmux 里如果你没有配置鼠标模式滚轮默认操作的是 tmux 自己的 buffer而不是终端原生的滚动这就导致你用系统终端自带的复制功能根本够不到历史内容。所以“全选”这个词实际上是两层意思把当前屏内容全选把整个回滚缓冲区的内容全选真正有用的方案必须把这两者都覆盖到。1.2 鼠标拖选为什么不行很多人的第一反应是我开启 tmux 的鼠标模式set -g mouse on然后用鼠标拖选不就行了能拖但坑很多。我实测下来有这几个问题tmux 的鼠标拖选默认操作的是 tmux 的 copy-mode复制结果进入 tmux 自己的 buffer并不会自动同步到系统剪切板。你拖完一看系统剪切板里还是旧内容。如果你的 tmux 里跑的是 vim、fzf 这类有自己的鼠标处理逻辑的程序拖选行为会被这些程序劫持结果要么是进了 vim 的寄存器要么是触发了 fzf 的选择反正不是你要的“窗格内容”。长行内容在 tmux 里会自动折行鼠标从中间开始拖结束位置稍微偏一点复制出来的内容就缺行、多行或者全是空格。结论是鼠标方案不是不能用而是不稳定、不可控。既然我们用 tmux就该用 tmux 自己的命令体系来干这件事。2. 两个核心命令copy-mode 全选与 capture-pane 导出2.1 capture-pane直接把窗格内容“照下来”tmux 提供了capture-pane这个命令作用是把指定窗格的当前内容捕获到 tmux 的缓冲区里。重点在几个参数上-t指定目标窗格不写就是当前窗格。-p把捕获结果直接打到标准输出stdout而不是存进 buffer。这是用来配合管道重定向的关键。-S指定捕获的起始行行号。写入负数比如-S -表示从回滚缓冲区的开头开始捕获这样才能把历史内容也捞出来。-E指定结束行行号默认是当前屏幕最后一行-E -表示捕获到 buffer 末尾。-J用于处理折行内容如果你想让被折行的长行重新拼接成完整一行这个参数很重要。举个最直接的例子把当前窗格的全部历史内容输出到文件tmux capture-pane -p -S - output.txt-S -的意思是“从一开始捕获到当前最后一行的全部内容”-p把内容打印到标准输出然后重定向写入文件。这条命令我用了很多次稳如老狗。2.2 copy-mode 全选在 tmux 内部完成选择另一条路线是进入 tmux 的 copy-mode复制模式用 tmux 自己的选择逻辑来完成“全选”这个动作然后复制到 buffer再存文件或转存系统剪切板。进入 copy-mode 的快捷键默认是Prefix [Prefix 通常是 Ctrlb。进入之后你处在类似 vi 或者 emacs 的按键环境里可以用方向键、PageUp/PageDown 浏览历史内容。如果你启用了 vi 键位set -g mode-keys vi全选的操作是Prefix [进入 copy-modeg跳到缓冲区最顶部V进入整行选择模式大写的 VG跳到缓冲区最底部y复制选中的全部内容这套组合最终是把全部历史内容复制到 tmux buffer。接下来再用tmux save-buffer -b buffer名 文件名存成文件或者用tmux paste-buffer粘贴到某个窗格里。但注意copy-mode 全选的结果还是停留在 tmux buffer 里要进系统剪切板还需要额外步骤。这也是为什么我更推荐直接走 capture-pane 管道一步到位。2.3 为什么优先推荐 capture-pane 而不是 copy-mode 手动全选我一开始用的是 copy-mode 手动全选后来慢慢切换到 capture-pane 为主原因很现实copy-mode 全选适合“人肉操作”偶尔用一次还行但你得记着一堆按键。capture-pane 可以写成别名、绑成键位、接入脚本完全不需要进入交互模式直接拿到结果。capture-pane 配合管道几乎可以无缝对接任何后续处理文件、剪切板、再加工处理。copy-mode 的全选依赖你手动按几个键real-time 操作时很容易误触而 capture-pane 是命令式的你可以放心做成快捷键。所以下面的实操部分我给出的主力方案是 capture-pane 管道组合。3. 实操把窗格内容全量输出到文件3.1 最简单的单条命令在 tmux 里选中某个窗格之后直接运行tmux capture-pane -p -S - /tmp/pane_content.txt这个命令的效果就是把当前窗格从创建之初到现在的全部内容导出到指定文件。打开这个文件你会发现里面不仅有屏幕上显示的内容还包括已经滚上去的历史输出。这里有个使用细节值得注意-p输出里包含了 tmux 用来表示颜色和样式的转义序列比如\x1b[32m这类如果你只是想要纯文本可以在导出后做一些清洗或者干脆关掉窗格里的颜色属性再捕获。不过大部分场景下直接捕获得到的文本已经足够阅读和搜索了。3.2 指定窗格捕获而不是局限在当前窗格有时候你人在窗格 A却想把窗格 B 的内容导出来。这种情况在调试多服务联动的场景下很常见你在一个窗格操纵命令另一个窗格持续在滚日志此时你想把日志窗格的最近内容存下来分析。tmux 的会话、窗口、窗格结构是分层的目标窗格可以用类似会话名:窗口号.窗格号的格式精确指定。比如tmux capture-pane -p -S - -t mysession:2.0 /tmp/log_pane.txt意思是捕获名为 mysession 的会话里第 2 个窗口的第 0 个窗格的全部内容。如果你不确定窗格编号可以先跑一句tmux list-panes -a查看所有窗格列表或者tmux display-message -p #{session_name}:#{window_index}.#{pane_index}获取当前所在窗格的完整 ID。3.3 用 save-buffer 走 tmux buffer 这一层如果你已经通过某种方式把内容放进了 tmux buffer比如用上面提到的 copy-mode 全选或者先 capture-pane 不带-p想把 buffer 内容导出到文件就用tmux save-buffer -a-a表示把全部 buffer 都保存。你也可以指定 buffer 名和输出文件tmux save-buffer -b buffer0 /tmp/pane_content.txtbuffer 的内容默认存储在 tmux 进程内存里不会因为会话切换而丢失。这个方案的好处是你在 capture 之后可以先看看内容再决定往哪儿存坏处是多了中间步骤不适合做成快捷操作。3.4 定时自动把窗格内容写入文件有时候你盯着的服务会在半夜崩掉早上醒来发现日志早就滚过去了。这时候如果你在 tmux 里跑了一个定时任务定时把某窗格内容导出到文件那是真的救命。在 tmux 配置里绑定一个键位来快速导出或者干脆用 shell 的 crontab 或者循环脚本while true; do tmux capture-pane -p -S - -t mysession:2.0 /tmp/log_capture.txt sleep 30 done每 30 秒把指定窗格的内容刷一次到文件配合tail -f查看最近状态。这个思路我用在一次线上排查里当时就是靠这种半自动导出才保住了崩溃前的输出。4. 实操把窗格内容直接送进本地剪切板文件是一种保存形式但更多时候你要的是“复制完立刻粘贴到别处”。下面我把 Linux、macOS、Windows 三套主流场景都列清楚。4.1 Linux 图形环境xclip / xsel 管道方案Linux 上用 X11 显示协议的话最常见的剪切板工具是 xclip 和 xsel。它们都可以从标准输入读取内容并写入系统剪切板。先确认工具是否装了which xclip which xsel没装就用发行版自带的包管理器装一下# Debian/Ubuntu apt install xclip xsel # Fedora dnf install xclip xsel # Arch pacman -S xclip xsel然后一条命令把 tmux 窗格内容灌进剪切板tmux capture-pane -p -S - | xclip -selection clipboard # 或者用 xsel tmux capture-pane -p -S - | xsel --clipboard --input注意这里的-selection clipboard因为 X11 下有两套选择机制PRIMARY 是中键粘贴的选区CLIPBOARD 才是 CtrlV 用的剪切板。如果不指定xclip 默认操作 PRIMARY你按 CtrlV 根本粘贴不出来这是初学者最容易踩的坑。4.2 Linux Wayland 环境wl-copy现在越来越多的发行版默认用 Wayland。在 Wayland 里 X11 的 xclip 并不是完全不能用有 XWayland 兼容但更可靠的是基于 Wayland 原生协议的 wl-clipboard 工具# 安装 wl-clipboard apt install wl-clipboard # 导出到剪切板 tmux capture-pane -p -S - | wl-copywl-copy 默认写的就是 CLIPBOARD粘贴直接 CtrlV 就能出来。这几个工具的性能都足够好即使窗格里有几十万行历史内容管道过去也没觉得卡。4.3 macOSpbcopy 天然支持macOS 自带pbcopy没有比这更省事的方案了tmux capture-pane -p -S - | pbcopypbcopy 会直接把标准输入写进系统的通用剪切板然后你就可以在任何 Mac 应用里 CmdV 粘贴。要复制到文件也简单 文件名重定向即可。macOS 上唯一要注意的是 tmux 版本不要太老老版本对 Unicode 字符的捕获处理有瑕疵可能导致中文内容粘贴出来是乱码。升级 tmux 到新版本基本就能解决。4.4 Windows 场景WSL 里借道 clip.exe如果你是在 Windows 下通过 WSL 使用 tmux那本地剪切板实际上由 Windows 系统接管。做法很简单用 WSL 里的 tmux 捕获然后把内容通过管道传给 Windows 的 clip.exe。tmux capture-pane -p -S - | clip.execlip.exe 是 Windows 自带的剪切板写入命令WSL 可以直接调用它。如果你用的是 Windows Terminal WSL还有另外一个思路直接用 tmux 的 copy-mode 完成选择后用鼠标右键复制Windows Terminal 的选择逻辑但那个方案还是绕不开鼠标不推荐。更好的做法是把上面这条命令绑成 tmux 快捷键让它变成一位速取的键位。5. 把整套操作绑成键位和别名日常效率直接翻倍5.1 在 tmux.conf 里绑定一键导出键位我的习惯是把“全量捕获到文件”和“全量捕获到剪切板”分别绑成两个不同的键。在~/.tmux.conf里加# 一键导出当前窗格全部内容到文件 bind-key F1 run-shell tmux capture-pane -p -S - ~/pane_capture_$(date %Y%m%d_%H%M%S).txt # 一键把当前窗格全部内容复制到系统剪切板 bind-key F2 run-shell tmux capture-pane -p -S - | xclip -selection clipboard保存配置后执行tmux source-file ~/.tmux.conf重新加载之后按Prefix F1就是导出文件按Prefix F2就是复制内容。Windows WSL 场景把 F2 那行改成bind-key F2 run-shell tmux capture-pane -p -S - | clip.exe5.2 用 shell 别名减少记忆负担如果你更喜欢在 shell 层面直接用命令可以往~/.bashrc或~/.zshrc里加别名alias pane2cliptmux capture-pane -p -S - | xclip -selection clipboard alias pane2filetmux capture-pane -p -S - /tmp/pane_output.txt这样你在任何路径下敲一句pane2clip当前窗格内容就进剪切板了。5.3 进阶只捕获指定行数的最近内容有时候你并不需要全部历史只要最近 30 行就够了。比如窗格里有海量日志全部导出反而干扰判断。-S -30就能限定起始位置tmux capture-pane -p -S -30 last_30_lines.txt负数表示往历史回退的行数正数表示从缓冲区开头的第几行开始。这个参数我经常用来捞崩溃前的现场日志。5.4 进阶捕获后自动修剪空行和 ANSI 控制符窗格内容一旦经过长文本输出和颜色渲染捕获结果里难免有控制符或者行尾的空格。我一般会用 sed 做一次简单清洗tmux capture-pane -p -S - | sed -r s/\x1B\[[0-9;]*[mK]//g | sed /^[[:space:]]*$/d cleaned_output.txt第一条 sed 把 ANSI 转义序列颜色码、清屏码一类删掉第二条 sed 删掉纯空白行。处理之后的内容拿来发工单、写复盘文档就非常干净了。6. 常见问题与排查实录6.1 复制出来的内容只有当前一屏历史内容没进来这个八成是-S -没加或者写错了。capture-pane默认捕获范围是“当前可见屏幕”如果你不带-S -它只会输出一屏的内容而不是历史全量。排查方式很简单先跑一句不带-S的命令再跑一句带-S -的命令对比文件行数立刻就能发现问题。6.2 导出内容整行拼接错误或者内容挤成一行tmux 的窗格宽度是有限的超过宽度的长行会被自动折行。capture-pane默认捕获的是折行后的状态也就是说一个逻辑长行可能被拆分成了好几段物理行。如果你想要的是“逻辑行被重新拼接回完整的一行”需要加-J参数tmux capture-pane -p -J -S - output.txt加了-J之后tmux 会尽量把折行内容合并成逻辑行。这个参数不是万能的对于某些带自动换行的文本比如 vim 里的软折行合并结果可能违背预期。我的建议是默认不加-J保留原始行结构遇到拼接需求再单独用。6.3 剪切板粘贴出来是空的或者还是旧内容这一步十有八九是工具链没通。xclip 没装、xclip 选的 selection 不对、Wayland 下没装 wl-clipboard、Windows WSL 下路径没写对都会导致管道“水泼不进”。我的排查顺序是先确认捕获本身有没有内容tmux capture-pane -p -S - | wc -l再测试管道目标echo test | xclip -selection clipboard然后 CtrlV 看能不能粘出来。如果 1 有内容但 2 粘不出来检查工具是否在 PATH 里、是否需要重新登录桌面会话。Wayland 下如果 xclip 失灵就装 wl-clipboard 改用wl-copy。6.4 绑定的快捷键没反应bind-key绑定后必须重新加载配置或重启 tmux 服务才生效。只改了~/.tmux.conf但没执行tmux source-file ~/.tmux.conf那当然没反应。还有一个隐蔽问题如果你把Prefix F1这种组合绑成别的快捷键冲突需要换一个键。最好先看一下当前所有绑定tmux list-keys | grep F16.5 捕获出来的中文乱码tmux 捕获对 UTF-8 支持本身没问题但如果你是在老终端环境、LC_ALL 没设置好或者捕获过程中经过某个转换就可能产生乱码。建议确认终端和 tmux 都跑在 UTF-8 模式tmux show-options -g status-utf8新版本 tmux 默认就是 UTF-8这个一般不用管。重点是不要在图省事的管道里多套一层 iconv 之类的东西。结尾我的一点经验之谈这套“capture-pane 管道 本地剪切板工具”的组合说穿了其实不复杂但每次我分享给别人对方都会感叹“原来 tmux 还能这么玩”。我自己用下来最深的感受是把频繁操作固化成键位才是这类技巧真正发挥价值的地方。如果你还停留在“鼠标拖选复制tmux窗格内容”的阶段我强烈建议花十分钟把上面这几个命令试一遍尤其是把Prefix F1导出文件和Prefix F2复制剪切板的绑定加进配置里。一次配置长期受益后面你会发觉自己再也回不去鼠标方案了。顺便留意一下tmux 版本尽量保持更新。很多细节-J的处理逻辑、Unicode 捕获、剪贴板管道的兼容性都在新版本里做了优化旧版本偶尔会出现奇怪行为。遇到异常先从版本出发排查往往能省下不少折腾时间。