VSCode Remote-SSH连接报错：tput: No value for $TERM and no -T specified

问题描述 #

本地Windows执行强制更新后，出现以下异常：

• VSCode通过Remote-SSH扩展无法连接远程服务器，但任意Shell（PowerShell、Git Bash等）直接使用SSH命令可正常连接
• 首次连接时，终端显示You are connected to: [company-servername]后，开始持续输出大量重复错误日志（对应截图内容）

已尝试但无效的操作：

• 重新安装Remote-SSH扩展
• 终止远程机器上的VSCode服务器进程
• 清理远程机器存储空间
• 仅保留Remote-SSH扩展运行VSCode
• 重新安装VSCode客户端
• 删除本地所有VSCode配置文件后重装
• 删除远程机器个人目录下的VSCode配置文件

解决方案建议 #

1. 核对VSCode的SSH路径配置 #

Windows更新可能修改了系统SSH环境，打开VSCode设置，搜索remote.SSH.path：

• 若当前指向第三方SSH客户端（如Git自带的ssh.exe），尝试切换为系统默认路径C:\Windows\System32\OpenSSH\ssh.exe
• 若当前使用系统SSH，尝试切换为第三方SSH路径测试

2. 禁用SSH代理转发与清理代理命令 #

Windows更新可能自动启用系统代理，干扰VSCode远程连接：

• 在VSCode设置中，将remote.SSH.enableAgentForwarding设为false
• 检查remote.SSH.proxyCommand配置，若存在自动添加的值，清空该字段

3. 手动指定远程VSCode服务器版本 #

本地VSCode版本与远程服务器版本不兼容可能导致连接失败：

• 打开VSCode命令面板（Ctrl+Shift+P），输入Remote-SSH: Connect to Host...
• 选中目标主机后，按住Shift键点击连接，弹出版本选择窗口
• 选择与本地VSCode版本完全一致的服务器版本，或最新稳定版尝试连接

4. 检查防火墙与安全软件拦截 #

强制更新可能重置防火墙规则，导致VSCode连接被阻断：

• 打开Windows Defender防火墙，确认VSCode应用及相关远程进程被允许通过防火墙
• 临时关闭第三方安全软件，测试连接是否恢复

5. 重置本地SSH密钥缓存 #

Windows更新可能导致SSH密钥缓存异常，执行以下命令修复：

# 清空现有密钥缓存
ssh-add -D
# 重新添加你的SSH私钥（替换为实际路径）
ssh-add C:\Users\<你的用户名>\.ssh\id_rsa

6. 开启详细日志定位具体错误 #

打开VSCode设置，将remote.SSH.logLevel设为trace，重新尝试连接。查看终端输出的详细日志，定位具体错误（如文件权限、路径冲突、依赖缺失等），再针对性处理。

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