OSC 52 (Operating System Command 52) 是一种终端转义序列，允许运行在终端中的程序（如 Vim、tmux 或通过 SSH 连接的远程程序）直接读写本地系统的剪贴板。
它的最大优势在于：即使你通过 SSH 连接到远程服务器，也可以实现本地与远程剪贴板的无缝统一。
快速检测：在终端执行
printf "\e]52;c;SGVsbG8=\a"。如果本地能粘贴出Hello，说明你的终端已原生支持，请直接开始配置。
1. 为什么它对 Server (无界面环境) 如此重要？
在没有图形界面的服务器上，传统的剪贴板工具（如 xclip 或 xsel）通常无法工作，因为它们依赖 X11 协议。而 OSC 52 的原理是通过 SSH 通道发送一串转义字符，让您本地的终端软件代为执行写入操作。
- 跨越 SSH：无论跳板机有多少层，最终都能同步到本地剪贴板。
- 无需 X11 转发：不需要开启 SSH 的
ForwardX11，安全性更高且速度快。 - 体验一致：在远程 Vim 中
y一下，本地直接Ctrl+V，无需改变习惯。
2. 配置指南：让工具支持自动复制
既然终端已准备就绪，我们需要让编辑器和 Shell 自动利用这一协议。
2.1 终端配置 (pbcopy)
遵循 Unix 哲学中“管道”的设计思想，我们可以将 OSC 52 封装为一个简单的命令。在 ~/.bashrc 或 ~/.zshrc 中添加以下别名，即可实现极简的管道复制：
# 将输入内容通过 OSC 52 发送到本地剪贴板alias pbcopy='printf "\e]52;c;$(cat | base64 | tr -d "\n")\a"'使用示例：
cat logs.txt | pbcopy # 将文件内容流向剪贴板history | tail | pbcopy # 组合多个命令并复制结果2.2 Vim 配置
对于传统的 Vim，可以添加以下函数到 .vimrc 中，实现按 y 自动触发 OSC 52：
function! Osc52Copy(str) let b64 = system('printf ' . shellescape(a:str) . ' | base64 | tr -d "\n"') let osc = "\e]52;c;" . b64 . "\a" call writefile([osc], '/dev/tty', 'b')endfunction
vnoremap y y:call Osc52Copy(@")<CR>2.3 Neovim 配置
Neovim 0.10+ 版本已经内置了对 OSC 52 的原生支持。由于许多终端出于安全考虑默认禁止“读取”剪贴板，建议使用以下配置以确保粘贴功能在无法从本地读取时能回退到内部寄存器：
local function paste() -- 从默认寄存器 "" 中获取内容，并按换行符分割 return { vim.fn.split(vim.fn.getreg(""), "\n"), vim.fn.getregtype(""), -- 同时返回寄存器类型 }end
vim.g.clipboard = { name = 'OSC 52', copy = { ['+'] = require('vim.ui.clipboard.osc52').copy('+'), ['*'] = require('vim.ui.clipboard.osc52').copy('*'), }, paste = { ['+'] = paste, ['*'] = paste, },}2.4 Tmux 配置
Tmux 默认会拦截 OSC 序列。为了让它透传到物理终端，你需要在 ~/.tmux.conf 中开启：
# 允许 tmux 将剪贴板序列转发给外部终端set -s set-clipboard on2.5 Fish Shell / Kitty 特化配置
如果你使用的是 Fish Shell 并且终端是 Kitty，你可以利用 Kitty 提供的 kitten 工具来实现更强大的剪贴板操作。虽然这不是纯粹的 OSC 52，但其目的完全一致：
在 ~/.config/fish/functions/pbcopy.fish 中添加：
function pbcopy --description "Copy to clipboard using kitty kitten" kitty +kitten clipboard $argvend如果你在 Fish 中仍想使用 纯粹的 OSC 52，可以使用以下函数：
function pbcopy printf "\e]52;c;$(cat | base64 | tr -d "\n")\a"end3. 核心原理：为什么能实现这个效果？
OSC 52 的核心原理可以概括为：“服务器发信号，本地终端执行”。
- 本质是“转义序列” (Escape Sequence)：终端不仅传输可见字符，还能传输“控制指令”。
- 谁在真正干活？
- 服务器端（被动）：只是向外发送一串特殊的字符串。
- 本地终端（主动）：截获特定的序列并调用本地系统 API 写入剪贴板。
- Base64 编码的作用：确保数据在传输过程中不会被 SSH 或 Shell 误解，保证指令完整到达。
4. 序列详解：\e]52;c;[Base64内容]\a
| 部分 | 字符 | 名称 | 解析 |
|---|---|---|---|
| 1 | \e] | 指令开始 | \e (ESC) + ] 声明这是一个 OSC 系统级命令。 |
| 2 | 52 | 命令编号 | 在协议中专门指代“操作剪贴板数据”。 |
| 3 | ;c; | 参数选项 | c 代表 Clipboard (系统剪贴板)。 |
| 4 | [...] | 负载数据 | 实际要复制的文本，必须经过 Base64 编码。 |
| 5 | \a | 结束标志 | Bell 字符（ASCII 7），告诉终端指令结束。 |
5. 常见终端支持情况
- 支持良好：iTerm2, Alacritty, Kitty, Windows Terminal, MobaXterm, PuTTY (最新版).
- 默认不支持：macOS 自带的 Terminal.app。
- 特别说明：如果你在 tmux 里验证失败，请务必检查
set-clipboard是否已开启。
6. 技术科普：为什么 macOS 自带终端不支持？
- 安全策略限制：允许远程服务器通过转义序列直接操作本地剪贴板存在风险。Apple 倾向于默认切断这种交互。
- 协议更新滞后：OSC 52 属于较新的 xterm 扩展指令，并非
Terminal.app的维护重心。
建议：如果你需要此功能，iTerm2 是 macOS 上的最佳替代方案。
总结这就像是在信件里夹了一张带有暗号的纸条。你的朋友（本地终端）看到暗号后，按照要求把内容抄到了他自己的笔记本上。