Node.js的node:readline模块按CTRL+D触发什么信号？如何拦截？

开发者阿泽

2026-8-27

问题背景

开发CLI工具时需要拦截CTRL+D组合键，将其映射为document相关功能，但使用node:readline模块搭配keypress事件时无法稳定拦截该按键。已观察到「此前按下过其他按键时，CTRL+D不会触发应用退出」的现象，但该表现属于readline行缓冲的非稳定逻辑，无法作为生产可用方案。原测试代码如下：

import readline from'node:readline'

const stdin = process.stdin
stdin.setEncoding('utf8')
const stdout = process.stdout
stdout.setEncoding('utf8')

const rl = readline.createInterface( stdin, stdout )

readline.emitKeypressEvents(stdin)
stdin.setRawMode(true)

rl.on('line', line => {
  console.log(line)
})

stdin.on('keypress', async (str, key) => {  
  if(key.name === 'd' && key.ctrl === true){
    console.log('CTRL-D')
  }
})

process.on('SIGINT', ()=>{
  console.log('CTRL+D??')
})

核心原因

不存在可监听的CTRL+D专属系统信号：POSIX终端规则下，CTRL+C对应SIGINT信号、CTRL+Z对应SIGTSTP信号，但CTRL+D是终端驱动层面识别的EOF（传输结束）控制字符，不会触发系统级信号，因此监听process上的信号事件无法拦截该按键。
原代码执行顺序错误：先初始化readline实例，再开启raw模式、绑定keypress事件，readline初始化时会提前注册自带的EOF处理逻辑，优先级高于后绑定的自定义keypress监听，空行状态下按下CTRL+D会直接被readline捕获触发进程退出。
异步keypress回调导致拦截失效：将keypress回调声明为async函数时，回调逻辑会进入事件队列下一轮执行，readline的同步处理逻辑会先拿到按键事件触发默认行为。
未拦截readline的默认close逻辑：空行状态下CTRL+D触发EOF时，readline会默认触发close事件并退出进程，未拦截该事件时即使识别到按键也无法阻止退出。

稳定拦截方案

按以下顺序调整代码即可实现全场景稳定拦截CTRL+D：

先对stdin开启raw模式、注册keypress事件监听，再初始化readline实例
监听readline的close事件，不主动调用process.exit()阻断默认退出逻辑
keypress事件回调不要直接声明为async，命中CTRL+D判断后再调用异步业务逻辑
手动保留CTRL+C的退出逻辑，避免raw模式下进程无法正常关闭

修正后可运行代码：

import readline from 'node:readline'

const stdin = process.stdin
const stdout = process.stdout
stdin.setEncoding('utf8')
stdout.setEncoding('utf8')

// 注意执行顺序：先配置raw模式、注册keypress事件，再初始化readline
stdin.setRawMode(true)
readline.emitKeypressEvents(stdin)

const rl = readline.createInterface({
  input: stdin,
  output: stdout
})

// 拦截readline默认close退出逻辑
rl.on('close', () => {
  // 不执行process.exit()即可阻止自动退出
})

rl.on('line', line => {
  console.log(line)
})

stdin.on('keypress', (str, key) => {  
  if(key.ctrl && key.name === 'd'){
    console.log('\n触发CTRL+D，执行document相关功能')
    // 如需执行异步逻辑，在此处调用即可，不要把整个回调改成async
    // await yourDocumentFunction()
    return
  }

  // 保留CTRL+C正常退出能力
  if(key.ctrl && key.name === 'c'){
    process.exit(0)
  }
})

额外说明

观察到的「按过其他按键后CTRL+D不会退出」现象，是因为非空行状态下readline不会将CTRL+D识别为EOF，仅作为普通按键传递给keypress事件，该逻辑依赖行缓冲状态，无法保证所有输入场景下表现一致，不建议依赖该特性实现拦截。

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