Posted 2026-02-27Updated 2026-03-01Note2 minutes read (About 295 words)

Neovim SSH 剪贴板配置

概述

SSH 远程环境下 Neovim 无法直接访问本地剪贴板，需要通过 OSC 52 转义序列实现跨终端复制粘贴。

OSC 52 配置

推荐配置（仅复制使用 OSC 52）

vim.g.clipboard = {
  name = 'OSC 52',
  copy = {
    ['+'] = require('vim.ui.clipboard.osc52').copy('+'),
    ['*'] = require('vim.ui.clipboard.osc52').copy('*'),
  },
  paste = {
    -- 粘贴使用终端快捷键，避免 OSC 52 paste 超时问题
    ['+'] = function() return vim.split(vim.fn.getreg(''), '\n') end,
    ['*'] = function() return vim.split(vim.fn.getreg(''), '\n') end,
  },
}

简化配置

1	vim.g.clipboard = 'osc52'

使用方法

操作	方式
复制	`"+y` 或 `"*y`（Neovim 内）
粘贴	终端快捷键 `Ctrl+Shift+V` 或 `Cmd+V`

常见问题

粘贴时显示”等待来自 OSC 52 的响应”

原因：OSC 52 的 paste 在 SSH 环境下不稳定
解决：使用上述推荐配置，paste 改用本地寄存器，粘贴时用终端快捷键

终端支持

支持 OSC 52 的终端：

iTerm2
Alacritty
kitty
Windows Terminal
tmux（需配置 set -g set-clipboard on）

Neovim 剪贴板工具优先级

1	g:clipboard → pbcopy → wl-copy → xsel → xclip → lemonade → tmux → osc52

SSH 环境下推荐直接指定 osc52。