tmux剪切板设置

主要针对mobaXterm中分屏使用tmux，vim下的剪切板使用。内容整理的有些杂乱，有空再调整吧。

tmux剪切板设置

使用场景
win11的host中通过mobaXterm终端ssh连接virtualbox中的centos8。在centos中使用tmux进行terminal复用。
需求
在tmux中，需要能复制terminal的内容，能在tmux内部paste，且需要能复制到win host中的clipboard，以便可以在host中的notepad++等工具中paste供后续使用。
分析
mobaXterm等终端工具，通常提供基于鼠标选择的终端内容复制。如mobaXterm中默认通过鼠标选中终端内容后，即自动复制到host的clipboard中，通过单击鼠标滚轮即可实现paste。
但在tmux下上述mobaXterm基于鼠标选择的复制方式受到限制，如通过ctl+b %进行分屏后，通过鼠标选择会选择到整个mobaXterm终端的内容，包含了多个pane的内容。即使tmux没有进行分屏，只有一个window的情况下，在vim下，通过vim的分屏，也会遇到类似的问题。
实际上tmux提供了copy-mode，在copy-mode下，可以在当前pane中指定范围进行内容copy。copy的内容可以在tmux管理的window、pane、session中进行paste。也可以结合xclip等工具将copy的内容通过X11发送到X server（mobaXterm会运行X server），从而通过X server发送到host的clipboard。也有一些不通过X11实现的方法，如pbcopy。
本文的解决方案即是基于tmux的copy-mode，在pane中选择指定的内容进行复制，并通过xclip连接X Server将复制内容发送到host的系统clipboard。

环境信息

. host: win11
. hypervisor: virtualbox 7
. vm: centos8
. terminal: mobaXterm 20

X11-forwarding设置

如上，本文方案基于X11，首先需要保证对应的X11-forwarding是正常工作的，具体方法参考MobaXterm 中X11-forwarding问题。如下图，配置ok后，在mobaXterm登录ssh session的初始界面会显示X11-forwarding是ok的：

tmux设置

tmux默认的copy-mode使用方式

1. 进入copy-mode：ctl+b [ 
2. 通过上下左右移动选择你需要开始copy的位置，ctrl+space开始copy
3. 通过上下左右移动扩大你要选择的范围
4. copy到tmux buffer：ctl+w或者alt+w
5. 在目标pane、window中paste：ctl+b ]

mobaXterm中ctl+space默认被设置为执行macro，需要重新指定，以防止与tmux冲突。

修改为vi的copy-mode
比较习惯vi下面的操作模式，可以将tmux修改为vi下的copy-mode，并且通过xclip将tmux复制内容发送到host的clipboard。

~/.tmux.conf

## Use vim keybindings in copy mode
#set-option -g mouse on
setw -g mode-keys vi
set-option -s set-clipboard off
bind P paste-buffer

bind-key -T copy-mode-vi v send-keys -X begin-selection
# this not work
# bind-key -T copy-mode-vi y send-keys -X rectangle-toggle
bind-key -T copy-mode-vi y send -X copy-selection-and-cancel
unbind -T copy-mode-vi Enter
bind-key -T copy-mode-vi Enter send-keys -X copy-pipe-and-cancel 'xclip -se c -i'
##bind-key -T copy-mode-vi MouseDragEnd1Pane send-keys -X copy-pipe-and-cancel 'xclip -se c -i'

vi的copy-mode用法

1. 进入copy-mode：ctl+b [ 
2. 通过hujk移动选择你需要开始copy的位置，v开始copy
3. 通过hujk移动扩大你要选择的范围
4/1. copy到tmux buffer（不拷贝到host的clipboard）：y
4/2. copy到tmux buffer，并发送到host的clipboard：Enter 
5/1. 在目标pane、window中paste：ctl+b ]或者ctl+b P
5/2. 在host中paste：ctl+v

参考文档
The Easy Way to Copy Text in Tmux
Copy and Paste in Tmux

tmux-copy-mode

linux安装xclip实现终端与剪贴板之间的通道

vi设置

原理
vim中有一个unnamed的register，y、yy、p等命令使用的即是这个register。而除了unnamed register，还有两个特殊的register，*和+。使用的时候通过"*和"+来指定使用。*y一般是selection register，即对应被选中的内容。通常Mac和windows中*和+都对应system clipboard。而此功能需要vim开启clipboard特性支持。利用它可以将vim复制的内容发送给host win11的系统clipboard。
*也有一些不基于clipboard的实现，详细见下面连接。

检查vim的clipboard功能是否开启
如果没开启的话源码编译vim，打开clipboard支持。

$ vim --version | grep clipboard
-clipboard         +keymap            +printer           +vertsplit
+eval              -mouse_jsbterm     -sun_workshop      -xterm_clipboard

下载vim源码

https://www.vim.org/download.php
https://www.vim.org/git.php
https://github.com/vim/vim

安装X依赖
```
yum install libX11-devel libXt-devel
```

编译安装vim（开启clipboard功能）

make distclean
./configure --with-features=huge --with-x --prefix=/usr/local
make
make install

检查vim的clipboard功能是否开启

## bash的cache机制，可能导致vim不刷新
[root@dw1-cn vim-9.0.1900]# hash -d vim
[root@dw1-cn vim-9.0.1900]# vim --version | grep clipboard
+clipboard         +keymap            +printer           +vertsplit
+eval              -mouse_jsbterm     -sun_workshop      +xterm_clipboard

vim的clipboard用法 - copy-mode

1. 进入copy-mode：v 
2. 通过hujk确定copy的范围
3/1. 拷贝到unnamed register并退出copy-mode：y
3/2. 拷贝到+/* register并退出copy-mode："+y或者"*y
4/1. 在目标buffer中paste：p
4/2. 在目标buffer中paste："+p或者"*p
4/3. 在host中paste：ctl+v

vim的clipboard用法 - 非copy-mode
以下常用复制命令，可以通过追加"+或者"*变更为复制到指定的clipboard

yank 当前行：yy
yank 4行：4yy
yank word：yw
yank直到下个X：yfX
yank到行尾：y$
yank到行首：y0/y^
yank一段（yank a paragraph）：yap

设置默认使用"+

~/.vimrc
这种方式将匿名clipboard和*+clipboard合并，使用比较方便，不需要特别指定clipboard（"*等方式）。但有些场景下会带来一些麻烦。如可能实现从系统中复制了一段文字，vim中编辑的时候，先dd删除了一段内容，又通过shift+insert粘贴system clipboard的内容，但是由于设置了默认使用了+clipboard，则dd的内容会覆盖掉之前复制的内容，导致粘贴的是dd的内容。还是推荐使用后面“推荐的方式”部分的方法。

:set clipboard=unnamedplus

也可以如此bind

noremap <Leader>y "*y
noremap <Leader>p "*p
noremap <Leader>Y "+y
noremap <Leader>P "+p

用法
上面绑定key的方法比较有局限性，只能适应于yw，yy等情况对于4yy等不适用
```
\y
\p
\Y
\P
```
Leader检查
```
:echo mapleader
```
Leader设置
```
let mapleader = ","
```

推荐的方式

# :命令模式下复制到*clipboard
:59,61 y *

# Esc普通模式下复制到*clipboard
"*4yy

# v进入copy-mode后，复制到*clipboard
"*y

更多
```
:help 'clipboard'
```
参考资料
How can I copy text to the system clipboard from Vim?
How can I copy over an ssh session without +clipboard?
Define custom commands for the * and + registers

tmux剪切板设置