穿透 wsl 和 ssh, 新版本 neovim 跨设备任意复制,copy anywhere!

获得更好的阅读体验,欢迎查看原文:穿透 wsl 和 ssh, 新版本 neovim 跨设备任意复制,copy anywhere!

1. 创作动机

最近一个星期,我入坑了 neovim, 然后开始配置各种插件。同一个时间点,我入手了一台 surface go2, 这是个 Windows 平板,我在上面也是装好了各种软件,配置了 wsl2, 并且配置了 ssh。然后我发现当我 ssh 连接到宿舍的高性能笔记本的时候,我打开 neovim 时候无法进行复制粘贴。严格地说,是无法进行复制,因为你无法使用 ctrl+shift+C 进行复制。所以我们通常在本机配置 opt.clipboard:append("unnamedplus") 来直接让 neovim 和系统剪贴板打通。但是这一次我们通过 ssh 传输数据,傻眼了。

因此,寻找一个可以通过 ssh 传输剪贴板的方案,迫在眉睫.

2. 原理介绍

首先,我们要介绍一下 nvim 传输剪贴板的方式。

第一步,当 neovim 执行 "*y 或者 "+y 的时候,就会把选中的内容写入到系统剪贴板中。这一步,并不是直接写入系统剪贴板的。neovim 会按照一定的优先级调用程序,而当某个程序符合要求的时候,neovim 就会调用这个程序。在以 X11 驱动的 Linux 桌面上,这个程序是 xclip。也就是说只要有 xclip 这个程序,neovim 就可以把内容写入到剪贴板。Wayland 、MacOS 、Windows 等平台都是有对应的剪贴板程序的,我们可以在 neovim 中使用 :help clipboard-tool 来查看对应的程序。

还是第一步,如果 neovim 是使用 ssh 远程连接的,那么远程的我们肯定也是无法访问到系统剪贴板的。所以我们可以通过设置 g:clipboard 这个变量,让 neovim 执行 "*y 或者 "+y 的时候,把内容作为传入到 g:clipboard 这个变量定义的函数中。这一步我们可以实现将复制的内容利用 OSC-52 传输到远程的机器上。

第二步,我们在本地的机器上操控远程的 neovim 时,会接收到传来的 OSC-52 内容。如果你的终端模拟器能支持 OSC-52 的话,它就会帮你自动的把传来的内容写入到系统剪贴板中。但是反过来的话却不一定,这个是安全原因,因为如果你的终端想要发送剪贴板的内容,必然需要读取系统剪贴板。这个是有风险的。如果开启,我们可以在远程上直接使用 p 命令粘贴。但是不开启的话,我们仍然可以进入 insert 模式,然后使用 ctrl+shift+v 粘贴。

第三步,我们配置好 g:clipboard 变量之后,就可以直接使用 "*y 或者 "+y 进行复制。但是如果我们想要更方便,不想使用寄存器,直接使用 y p 命令,那么我们需要让 neovim 默认使用无名寄存器,配置加入这么一条就行了: opt.clipboard:append("unnamedplus")

如图就是这一套剪贴板内容传输的流程图。当你配置完成之后,你就可以不需要多余的操作而直接复制粘贴了。

下面就是具体的各种情况的配置过程。

3. 配置 ssh 传输

3.1 理论基础

ssh 传输剪贴板是目前用处最广的, 配置它我们就需要利用好 OSC-52 协议。

首先,我们需要确认好我们目前使用的终端是否支持 OSC-52 协议。网上可以找到一张主流终端模拟器是否对 OSC-52 协议的支持表。这里我就贴下来了。

  • Windows平台 - Windows Terminal:支持
  • Mac 平台 - iTerm2:支持
  • Mac 平台 - terminal.app:不支持
  • Ubuntu 平台 - Gnome Terminal:不支持
  • Chromebook - hterm:支持
  • 跨平台 - alacritty:支持
  • 跨平台 - kitty:支持
  • 终端复用 - tmux:支持
  • 终端复用 - screen:支持

也就是说,当你使用 Windows Terminal 作为你连接和使用远程 linux 上的 neovim 时,你就可以直接使用 OSC-52 协议进行剪贴板传输,请放心使用。

然后,我们需要在远程的 neovim 中配置 g:clipboard 变量。这个变量分为两个部分,一部分是 copy,另一部分是 paste。copy 部分是当执行 "*y 或者 "+y 的时候,把选中的内容作为参数传给 g:clipboard.copy,paste 部分是当执行 "*p 的时候,把远程的 neovim 的剪贴板内容作为参数传给 neovim 来直接粘贴。然而通常,paste 会导致终端读取我们本地的剪贴板,经过网络传输,不太安全。所以一般大部分终端模拟器的 OSC-52 协议是不可读取的。这包括了 Windows Terminal

打开 neovim, 输入 :help clipboard-osc52 就可以看到 OSC-52 的帮助文档。这说明 neovim 已经原生支持了 OSC-52 协议。网上似乎说这一条的毕竟少,毕竟 neovim 0.10 是三个星期前刚发布的,之前用的人多了就没有关注这个新配置。而我正好是最近入坑的,查帮助文档看到了这个。在此之前人们基本上都是推荐 vim.oscyank 这个插件来支持 OSC-52 协议的。既然有原生的支持,我们就不需要再安装这个插件了。

3.2 按照官方文档配置

我们先在 neovim 里面执行 :help clipboard-osc52 看一下官方文档。如果你之前正常配置过 neovim ,就应该会有一个自己的配置文件目录,这里不再赘述,所以我们直接贴出官方的配置文档。

    vim.g.clipboard = {
      name = 'OSC 52',
      copy = {
        ['+'] = require('vim.ui.clipboard.osc52').copy('+'),
        ['*'] = require('vim.ui.clipboard.osc52').copy('*'),
      },
      paste = {
        ['+'] = require('vim.ui.clipboard.osc52').paste('+'),
        ['*'] = require('vim.ui.clipboard.osc52').paste('*'),
      },
    }

我们只需要把这一段配置复制到自己的配置文件中,然后重启 neovim 即可。

如果配置到这里就结束了,那么也不失为美好的结果。但是既然是个新东西,又怎么会让你如愿呢?

之前说过,Windows Terminal 是不支持读取剪贴板的,所以当远程的 neovim 尝试执行 "*p 的时候,会试图通过 OSC-52 协议读取本地剪贴板的内容,然后传给远程的 neovim。但是 Windows Terminal 是不支持读取剪贴板的,所以这个过程会失败。我们在 neovim 中执行 :reg 来查看寄存器,可以看到 neovim 弹出了报错:

Waiting for OSC 52 response from the terminal. Press Ctrl-C to interrupt ...

正因如此,每当我们执行 "*p 的时候,都会弹出一个报错。我们必须要手动按下一个回车键,才能正常粘贴,而且粘贴的还是普通的 "" 临时寄存器。这非常的影响体验。因为我们确实只需要复制功能,粘贴功能我们只需要进入 INSERT 模式,然后使用 ctrl+shift+v 粘贴就可以了。现在我们来重新配置一下,让它不再报错。

3.3 配置不报错

上文说到,如果本地终端不支持剪贴板的读取,那么远程的 neovim 会尝试通过 OSC-52 协议读取本地剪贴板的内容,然后失败,影响写作体验。

在 github 上有这么一个 issue,提出了一个解决方案如下:

function no_paste(reg)
    return function(lines)
        -- Do nothing! We can't paste with OSC52
    end
end

vim.g.clipboard = {
    name = "OSC 52",
    copy = {
         ["+"] = require("vim.ui.clipboard.osc52").copy("+"),
         ["*"] = require("vim.ui.clipboard.osc52").copy("*"),
    },
    paste = {
        ["+"] = no_paste("+"), -- Pasting disabled
        ["*"] = no_paste("*"), -- Pasting disabled
    }
}

可以看到,这个方案是直接把 paste 设置为一个空函数。这样当 neovim 执行 "*p 的时候,就不会再试图去利用 OSC-52 协议读取本地剪贴板的内容了。

但是这个方法有一个问题,就是说当进行粘贴的时候,因为函数返回的格式并不符合官方文档的要求,那么 neovim 就会报错。

clipboard: provider returned invalid data

这个报错每一次粘贴都会出现,还是红字非常刺眼。我对此很难受,所以还需要想办法解决这个问题。解决思路就是:因为我们预期的粘贴命令是粘贴 neovim 自己的 y 复制,所以我们只需要让 paste 可以返回 "" 临时寄存器的内容就可以了。

以下就是我的配置,把上面的配置替换成下面这个:

function my_paste(reg)
    return function(lines)

        --[ 返回 “” 寄存器的内容,用来作为 p 操作符的粘贴物 ]
        local content = vim.fn.getreg('"')
        return vim.split(content, '\n')
        
    end
end

if (os.getenv('SSH_TTY') == nil)
then
    --[ 当前环境为本地环境,也包括 wsl ]
    opt.clipboard:append("unnamedplus")
else
    opt.clipboard:append("unnamedplus")
    vim.g.clipboard = {
      name = 'OSC 52',
      copy = {
        ['+'] = require('vim.ui.clipboard.osc52').copy('+'),
        ['*'] = require('vim.ui.clipboard.osc52').copy('*'),
      },
      paste = {
        --[ 小括号里面的内容可能是毫无意义的,但是保持原样可能看起来更好一点 ]
        ["+"] = my_paste("+"),
        ["*"] = my_paste("*"),


    },
}
end

在这一段 lua 配置中,可以看到我用了一个 if 条件判断,检测 $SSH_TTY 环境变量来检测是否为本地环境。如果当前环境是本地环境,那么除了使用 unnamedplus 寄存器以外什么也不做,否则就使用 OSC-52 协议传输剪贴板。

关于本地环境,因为没有设置 g:clipboard 变量,所以 neovim 就会根据 :help clipboard-tool 文档来选择默认的剪贴板。因为我们 linux 机器上面安装了 xclip 这个软件,所以 neovim 就会把内容复制到本地的系统剪贴板。

而远程环境,因为设置了 g:clipboard 变量,所以 neovim 会使用 OSC-52 协议来传输它打算复制到系统剪贴板的内容。而粘贴的时候,则会调用我写的 my_paste 函数,这个函数会返回 "" 寄存器的内容。因此,我成功的把 p 的功能给修复到了正常的状态。

4. 配置 tmux (可选)

如果你使用的是 tmux,那么你可以通过配置 tmux 来跳过步骤 3。我并没有使用 tmux 的打算,但是如果你使用 tmux,那么你需要配置一下。网上关于 tmux 开启 OSC-52 协议的配置很多,这里我不再赘述,我也暂时没有配置的打算。我只讲一下 tmux 代理的原理。

其实也非常好懂,当你使用 tmux 的时候,neovim 不会认为你的终端是来自远程 ssh 连接的。他只知道将内容发送到 tmux 进程,然后由 tmux 转发给远程的 neovim。

根据官方文档,tmux 只需要这么设置就可以开启 OSC-52 协议了。

.tmux.conf 文件中添加如下配置:

set -s set-cliplboard on
# 好像还有一些,为了避免误人子弟还是建议自己去查一下

这样,tmux 就会把内容发送给本地终端。

勘误: 上文说到,neovim 不会认为你的终端是来自远程 ssh 连接的。其实这句话是不对的,$SSH_TTY 环境变量是否设置,取决于你的 tmux 实在什么环境下开启的。那么如果你是 tmux 和直连混用的人,你需要这么配置

首先先 echo $TERM 检查一下你的终端类型。通常情况下,当我直连终端时,这个值为 xterm-256color,当使用 tmux 的时候,这个值会变成 tmux-256color

然后,改写我之前的 lua 配置,利用 if (os.getenv('TERM') == 'tmux-256color') 判断。具体的配置教程可以参考 :help g:clipboard, 也可以参考网上教程。

5. 配置 wsl

到了这里,我很高兴的告诉你,在我的设备上(wsl 2.1.0, neovim 0.10.0),只需要一个 opt clipboard:append('unnamedplus'),wsl 就会自动和系统剪贴板交换,虽然使用 win+V 快捷键查看系统剪贴板可能不一定能看见。

如果你的配置还是不行,建议参考一下 :help clipboard-wsl

6. 总结

我本来是不愿意来 neovim 的,所以自从接触 vim 之后也是过了大半年才入了 neovim 的坑。正因为来晚了,我才看到官方已经原生支持 OSC-52 协议了。当然对于各位早已入坑的 neovim 玩家来说,也完全没必要去折腾。我希望这篇文章能带给和我一样的 neovim 新手,让他们能够在被 neovim 的剪贴板折磨的时候,能够通过搜索引擎,搜索到这么一篇 2024 年的教程。也希望大家和我多多交流,互相学习。个人网站下方的评论区已开放,欢迎大家来到博客园、知乎、个人网站的评论区一起交流。


作者:Sxrhhh

个人网站:https://www.sxrhhh.top

博客园:Sxrhhh - 博客园 (cnblogs.com)

转载请注明出处.

在个人网站持续更新中……

热门相关:独步仙尘   妖魔哪里走   黄金渔场   司令,以权谋妻   农家小福女