tmux 简易指南（二）

Sam Xie included in category Programming

2019-02-23 2019-02-23 799 words 4 minutes

Contents

上次简单介绍了 tmux 的一些基本概念和用法，能让我们很快的上手使用。但想用的顺手我认为还需要做些改进。

所以，本篇主要分享自己目前在用的 tmux 配置，并附上详细说明原因，自己以后查阅也方便。

在分享前

先介绍几个概念，tmux 中有几种常见配置：

快捷键(key)：可以通过 bind-key 命令来配置，比如 tmux bind-key S choose-tree 意思是绑定 S 用来触发 choose-tree 这个 tmux 命令（当然，要先按 prefix key ），效果和直接再 tmux session 中输入 tmux choose-tree 是一样的。
变量(option)：比如 tmux set-option history-limit 10000 是设置 tmux 的历史长度

这些配置都可以放到 ~/.tmux.conf 这个文件下，tmux 第一次启动时，会加载这些配置。

在运行 tmux 时，可以通过 prefix key + :，然后输入 source-file ~/.tmux.conf 手动重新加载配置。不过呢，和 shell 一样，tmux 加载配置只是修改配置中对于的变量，对于旧的没被覆盖的配置，还是会在的。

所以有时候我会 tmux kill-server 直接杀掉 tmux 进程，再重新打开 tmux 来保证配置加载的完整性。

放一张配置完的图，也是上一篇的第一张图

开始吧

开胃菜

1
2
3


# Common config
set-option -g set-titles on
set-option -g set-titles-string "#S / #W"

tmux 默认不会改 Terminal 的 title，所以在终端软件的 tab 名字里面只有 “tmux”，这对于同时要开很多个 tab 的人来说很不友好。所以我开启了 title ，并把它的格式改为 当前 session 名字 / 当前 window 名字

1

set-option -g repeat-time 1000  # default is 500

tmux 在执行连续的快捷键时（比如切换 pane ），默认只有 500ms 的等待时间，超过这个时间，就会退回到正常输入模式，有时候稍微按得慢一点（也可能是我手残），就要重新按 prefix key 来重新输入快捷键，所以我把他改为 1s 。

1

set-option -g history-limit 10000

默认的历史行数比较小，改大一点，看程序日志的时候不至于被吃掉。（有时候我会吧 tmux 当成临时的 supervisor 进程管理解决方案）

1
2
3


# Terminal type configuration
set-option -g default-terminal "screen-256color"
set-option -ga terminal-overrides ",xterm-256color:Tc"

tmux 中的颜色可能和 shell 中的有所偏差，使用如上设置使得颜色能正常显示。

副菜

作为 Vim 党，当然希望 tmux 中也能用到一些 Vim 类的快捷键。

1

set-window-option -g mode-keys vi

这样就可以在滚动模式（copy-mode）中，使用一些 Vim 键位了。

不过我觉得这还不够 Vim ，还需要进一步的设置。

1
2
3
4
5


# Move & Copy while scrolling
bind-key -T copy-mode-vi v send-keys -X begin-selection
bind-key -T copy-mode-vi y send-keys -X copy-selection-and-cancel
bind-key -T copy-mode-vi u send-keys -X halfpage-up
bind-key -T copy-mode-vi d send-keys -X halfpage-down

浏览历史的时候，可以用 v 选择，y 复制，u/d 翻页。

1
2
3
4
5


# Select pane
bind-key -r j select-pane -D
bind-key -r k select-pane -U
bind-key -r h select-pane -L
bind-key -r l select-pane -R

使用 j,k,h,l 来选择 pane 。

1
2
3
4
5
6
7
8
9


bind-key -r M-j resize-pane -D
bind-key -r M-k resize-pane -U
bind-key -r M-h resize-pane -L
bind-key -r M-l resize-pane -R

bind-key -r M-J resize-pane -D 5
bind-key -r M-K resize-pane -U 5
bind-key -r M-H resize-pane -L 5
bind-key -r M-L resize-pane -R 5

使用 Meta + j,k,h,l 来调整 pane 大小（如果使用 iTerm 的话，可能需要把 Option 键位设置成，Esc+ 键）

主食

显示当前运行程序

程序输出日志多了，不清楚当前执行的程序是什么了？

1
2
3
4
5
6
7


# Pane border
set-option -g pane-border-status top
# Show current cmd
if-shell "uname | grep -q Darwin" \
  "set-option -g pane-border-format ' #P: #(sleep 0.25; ps -t #{pane_tty} -o args= | tail -n 1) '"
if-shell "uname | grep -q Linux" \
  "set-option -g pane-border-format ' #P: #(sleep 0.25; ps -t #{pane_tty} -o args= --sort=etime | head -n 1) '"

我的方案是打开 pane 的 title ，然后把 title 设置为当前执行的程序 cmd 。

原理为使用 ps 命令显示当前 tty 下执行的进程，并显示 cmd 。

然而，这可能会打出多个进程，因为进程和它的子进程会被同时打印出来。比方说用 bash 执行了一个 shell 脚本，脚本内容如下：

1

sleep 3600

如果只显示父进程，那么结果是 bash foo.sh，并不能清楚知道脚本执行到哪了，我希望看到的是 sleep 3600，所以需要根据 ps 得到的结果，来获取子进程的 cmd 。

由于平台不一样 ps 的实现也是不一样的。经过测试，macOS 和 linux 的 ps 打印出来的子进程顺序是相反的，所以两个平台要区分开来对待：Darwin 内核（也就是 macOS 的内核）的用 tail -n 1，linux 内核用 head -n 1 来获取子进程的 cmd 。

关于命令中的 sleep 0.25 主要是因为，有时候会出现 title 失效不更新的情况，加入该命令可以极大的减少该情况的出现。

快速切换 session

同时打开的 session 有点多时，会很不方便切换。虽然 tmux 提供了 prefix key + s 来显示所有的 session 并且可以用方向键来选择切换。

但还是不够好用，我想要的是像 Context 一样的通过用 session name 来切换的功能，并且提供 fuzzy search，并在我打错字个别字时也能正常切换。

这样我只要知道 session name ，闭着眼睛也能切换 session ，不用盯着屏幕看，不用在意 session 的排序位置。

这个功能依赖 fzf 中的 fzf-tmux 程序

1
2


bind-key s run-shell "tmux list-sessions -F \"##S\" | fzf-tmux | xargs tmux switch -t; true"
bind-key S choose-tree -s

按下 prefix key + s ，你将会看到 tmux 跳出一个额外的 pane ，上面显示了所有的 session name。

你可以通过方向键选择，也可以直接输入 session name，回车即可跳转到该 session 。

有时候 tmux 自带的 choose-tree 也挺有用的，所以我把它的键位移到到了 prefix key + S 。

沙拉

tmux 滚动模式的坑

tmux 在进入 copy mode （查看 pane 历史）时，会暂停读取在 pane 中运行的 tty 的 stdout 和 stderr ，如果 tty 中的程序继续往标准输出中写入，那么操作系统的 tty 缓存最终会被填满。此时程序再写入时，为避免缓冲区溢出，操作系统会会阻塞该 IO 操作。此时该程序很有可能被阻塞，假如这个程序是个提供 web 服务的 server，那么它将停止响应所有的请求。

目前 tmux 官方没有打算解决这个问题（可能是 tmux 实现原因），但有方法可以绕过这个坑。

1
2


Show history as scrollable view
bind-key F capture-pane -S -10000 -b capture\; show-buffer -b capture\; send-keys G\; delete-buffer -b capture

原理是捕获当前历史，保存到 tmux buffer 中，然后再显示 buffer 的内容。这个方案和 copy mode 的区别就是会丢失 shell 中的颜色。（tmux show-buffer 命令不支持显示颜色）

保存历史到文件

tmux 中的历史不能像普通的 shell 一样，可以通过滚动终端类软件的自带的历史记录来截取日志，假如要截取的日志很长一段，没法直接在一个页面中打印出来怎么办？

1

bind-key P command-prompt -p 'save history to filename:' -I '~/tmux.history' 'capture-pane -S -10000 -b capture ; save-buffer -b capture %1 ; delete-buffer -b capture'

按下 prefix key + P 即可把历史记录保存到文件中，然后想怎么分析就怎么分析 xD 。

甜点

继承当前目录

打开一个新的 pane 或 window ，当前目录不会继承自上一个 pane ，每次都会在用户目录，挺不方便的。

1
2
3
4
5
6
7


# -- Split with current direcotry --
# Split panes horizontal
bind-key '%' split-window -h -c '#{pane_current_path}'  
# Split panes vertically
bind-key '"' split-window -v -c '#{pane_current_path}'
# Create new window
bind-key c new-window -c '#{pane_current_path}'

插件管理

tpm 是 tmux 中的插件管理器，可以用来安装管理自己喜欢的 tmux 插件，非常方便。

安装

1

git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

推荐些我用的插件

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


# =---- Plugins ----=
set -g @plugin 'tmux-plugins/tpm'
set -g @plugin 'tmux-plugins/tmux-sensible'
set -g @plugin 'XSAM/tmux-themepack'

# Continuous saving tmux environments
set -g @plugin 'tmux-plugins/tmux-resurrect'
# set -g @plugin 'tmux-plugins/tmux-continuum'
# =---- Plugins ----=

# Initialize TMUX plugin manager (keep this line at the very bottom of tmux.conf)
run -b '~/.tmux/plugins/tpm/tpm'

tmux-plugins/tmux-sensible：帮你配置了一些常规的设置
XSAM/tmux-themepack: 我改的主题（自认为还挺好看的 xD)
tmux-plugins/tmux-resurrect: 能保存 tmux 的 session 结构，这样关机重启之后，能马上恢复

咖啡、茶

我维护了一个叫 kind-lazy 的项目，提供一些程序的快速安装脚本，其中也有本文提到的 tmux 配置。

快速安装 tmux ：

1
2
3


git clone https://github.com/XSAM/kinda-lazy.git
cd kinda-lazy/tmux
bash lazy_install.sh

喜欢的话可以给项目点个 Star 🚀

Enjoy!