VSCode远程SSH调试bash脚本时TUI不显示报错如何解决

• 开发环境：通过远程SSH连接使用VS Code开展bash开发，编写的脚本调用Dialog应用创建TUI（文本用户界面）
• 正常运行表现：在VS Code打开集成终端，通过命令行直接运行bash脚本时，TUI可正常在终端内展示
• 调试异常表现：使用调试器运行脚本，执行到TUI相关代码段时TUI无法正常显示，调试控制台持续打印如下报错：

cannot open tty-output
TIMEOUT SCANNING

Dialog这类TUI应用需要直接读写真实的交互终端（tty）设备才能完成界面渲染、输入捕获操作。VS Code启动bash调试进程时，默认可能将进程的标准输入输出绑定到无tty属性的调试控制台通道，或者被调试扩展劫持了标准流，导致Dialog无法获取可用的tty设备，触发输出打开失败、输入扫描超时的报错。

• 调整调试配置的终端类型
  打开项目目录下.vscode/launch.json中对应的bash调试配置项，将console字段从默认的internalConsole（调试控制台，无真实tty）修改为integratedTerminal（VS Code集成终端）或externalTerminal（系统外部终端），注意不要使用internalConsole模式，要确保调试进程运行在具备完整tty能力的交互终端中。参考配置如下：

  {
      "type": "bashdb",
      "request": "launch",
      "name": "调试当前Bash脚本",
      "program": "${file}",
      "console": "integratedTerminal",
      "cwd": "${fileDirname}"
  }
  

• 为Dialog调用显式指定tty设备
  如果调整终端配置后仍报错，在脚本中调用Dialog的位置显式绑定当前会话的tty设备，两种写法均可：

  # 写法1：加--tty参数指定设备
  dialog --tty /dev/tty --msgbox "测试弹窗" 10 30
  
  # 写法2：重定向输入输出到tty设备
  dialog --msgbox "测试弹窗" 10 30 < /dev/tty > /dev/tty
  

• 关闭调试器的流劫持配置
  部分版本的Bash调试扩展会默认捕获被调试脚本的标准输入输出流用于日志展示，会阻断TUI应用和终端的直接通信。可在launch.json的调试配置中添加"outputCapture": "none"字段，关闭调试器对流的拦截。
• 检查远程SSH会话的tty权限
  远程连接场景下先在集成终端执行tty命令获取当前终端的设备路径（通常为/dev/pts/数字格式），执行ls -l [获取到的tty路径]确认当前登录用户对该设备具备读写权限，权限异常时可执行chmod 600 [tty路径]修复。

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