如何避免粘贴`tab`字符时触发readline自动补全？

要让粘贴的Tab作为普通字符插入，同时保留按键Tab的补全功能，核心是利用Readline的括号粘贴模式（Bracketed Paste Mode）——这也是psql和现代bash实现该行为的标准方式。

具体实现步骤 #

1. 启用括号粘贴模式
   在初始化Readline的代码中添加以下配置，让Readline自动识别终端发送的粘贴起止序列，在粘贴期间将所有输入（包括Tab）作为普通字符处理：

// 启用括号粘贴模式，区分按键输入与粘贴输入
rl_variable_bind("enable-bracketed-paste", "on");

2. 保留Tab键的补全绑定
   默认情况下，Readline的Tab键绑定的是complete函数，无需额外修改。如果之前自定义过Tab的绑定，确保仅在非粘贴模式下触发补全逻辑即可（括号粘贴模式会自动覆盖粘贴时的Tab行为）。

原理说明 #

终端的括号粘贴模式会在粘贴内容前后发送特定控制序列（\e[200~和\e[201~），Readline识别到这些序列后，会进入临时插入模式，此时所有输入字符（包括Tab）都会直接插入命令行，不会触发补全或其他快捷键逻辑。粘贴结束后自动恢复正常模式，按下Tab仍会触发补全。

兼容处理（针对不支持括号粘贴的终端） #

如果运行环境的终端不支持括号粘贴，可以通过自定义Tab处理函数实现近似效果：

int custom_tab_handler(int count, int key) {
    // 简单判断粘贴场景：比如结合输入速度、连续输入痕迹等
    // 此方法准确性有限，仅作为 fallback
    if (is_pasting) {
        rl_insert_text("\t");
        return 0;
    } else {
        // 触发原有补全逻辑
        return rl_complete(count, key);
    }
}

// 绑定自定义Tab处理函数
rl_bind_key('\t', custom_tab_handler);

但这种方法的准确性依赖于对粘贴场景的判断，优先推荐使用括号粘贴模式。

内容的提问来源于stack exchange，提问作者Jie Feng