VSCode Remote-SSH 扩展故障排查：解决 "Creating 'sh' subshell timed out" 错误

问题现象

在使用 VSCode 的 Remote-SSH 扩展连接远程开发环境时，用户遇到了两种不同的错误提示：

1. 当设置 remote.SSH.useLocalServer 为 true 时，出现错误："Resolver error: Error: Creating 'sh' subshell timed out"
2. 当设置为 false 时，则显示："Resolver error: Error: Client-side server download failed"

这些错误导致用户无法通过 Remote-SSH 扩展连接到远程的 coder.com 实例，尽管直接使用 SSH 命令行连接仍然正常工作。

错误分析

从日志中可以观察到几个关键点：

1. SSH 连接本身是成功的，认证过程正常完成
2. 问题出现在尝试创建远程 shell 子进程时
3. 错误提示表明系统无法正确执行 sh 命令

深入分析日志发现，当 Remote-SSH 扩展尝试在远程主机上执行 sh 命令时，实际上执行了一个错误的二进制文件，这个文件实际上是用户之前安装的 shfmt 工具（一个 shell 脚本格式化工具）的别名。

根本原因

问题的根源在于用户的 $PATH 环境变量设置导致：

1. 用户曾在远程主机上安装了 mvdan/sh 项目中的工具，包括 shfmt
2. 安装过程中可能同时安装了名为 sh 的可执行文件
3. 这个自定义的 sh 被放置在 ~/.local/bin 目录下
4. 由于 ~/.local/bin 在 $PATH 中的优先级高于系统默认的 /bin 或 /usr/bin
5. 当 Remote-SSH 扩展尝试执行 /bin/sh 时，系统实际执行了用户自定义的 sh 工具

解决方案

解决此问题的方法很简单：

1. 登录到远程主机
2. 检查 ~/.local/bin 目录下是否存在名为 sh 的可执行文件
3. 移除或重命名这个文件
4. 确保系统默认的 /bin/sh 可以被正常访问

验证方法是通过 SSH 直接执行测试命令：

ssh coder.bwm sh <<< 'echo "hello from in $(ps -o comm= -p $$)"'

正常情况下应该返回类似 "hello from in sh" 的输出，而不是任何帮助文本。

预防措施

为避免类似问题，建议：

1. 避免在个人目录下安装与系统关键命令同名的可执行文件
2. 如果需要安装替代工具，使用不同的名称或完整路径调用
3. 定期检查 $PATH 环境变量的设置，确保系统目录优先级合理
4. 使用 which sh 命令检查实际执行的二进制文件位置

技术要点

1. Remote-SSH 扩展依赖远程主机上的标准 shell 环境进行初始化
2. 扩展会在远程主机上执行复杂的 shell 脚本来建立连接
3. 任何对基本系统命令的修改都可能导致连接失败
4. 调试此类问题时，应首先验证最基本的命令执行是否正常

通过理解这些技术细节，用户可以更好地诊断和解决 Remote-SSH 扩展使用过程中遇到的各种环境配置问题。