Windows 10上VSCode SSH连接失败的终极解决方案
当你第一次在VSCode中使用SSH连接远程服务器时，看到"An SSH installation couldn't be found"这样的错误提示确实会让人感到困惑。作为一个长期使用Windows开发环境的程序员，我完全理解这种挫败感。但别担心，这通常只是OpenSSH组件没有正确安装或配置的问题。
Windows 10从1809版本开始就内置了OpenSSH客户端和服务器组件，只是默认没有安装。本文将带你一步步解决这个问题，从最基本的组件安装到防火墙配置，再到最后的连接测试，确保你能顺利使用VSCode进行SSH远程开发。
1. 确认OpenSSH组件安装状态
在开始任何安装操作前，我们首先需要确认系统当前的OpenSSH组件状态。这可以避免重复安装或遗漏必要组件。
打开PowerShell（不是命令提示符CMD），最简单的方法是按下Win+X，然后选择"Windows PowerShell（管理员）"。务必使用管理员权限，否则后续的安装步骤可能会失败。
在PowerShell中输入以下命令检查OpenSSH状态：
Get-WindowsCapability -Online | Where-Object Name -like 'OpenSSH*'你会看到类似这样的输出：
Name : OpenSSH.Client~~~~0.0.1.0 State : NotPresent Name : OpenSSH.Server~~~~0.0.1.0 State : NotPresent如果两个组件的状态都是"NotPresent"，说明你需要安装它们。如果已经显示"Installed"，则可以跳过安装步骤。
2. 安装OpenSSH客户端和服务器
安装OpenSSH组件其实非常简单，只需要两条命令。但这里有几个关键点需要注意：
- 必须使用管理员权限的PowerShell
- 客户端和服务器最好都安装，即使你只需要其中一个
- 安装过程中保持网络连接稳定
下面是安装命令：
# 安装OpenSSH客户端 Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0 # 安装OpenSSH服务器 Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0安装过程会有进度指示，客户端安装通常很快，服务器端可能需要稍长时间。安装完成后，你应该看到类似这样的输出：
Path : Online : True RestartNeeded : False如果"RestartNeeded"显示为True，建议重启系统后再继续后续步骤。
3. 配置SSH服务器并设置防火墙
安装完组件后，我们需要对SSH服务器进行基本配置并确保防火墙不会阻止连接。
3.1 启动SSH服务
首先启动SSH服务并设置为开机自动启动：
# 启动SSH服务 Start-Service sshd # 设置SSH服务为自动启动 Set-Service -Name sshd -StartupType 'Automatic'3.2 配置防火墙规则
Windows应该会自动创建所需的防火墙规则，但最好手动确认一下：
if (!(Get-NetFirewallRule -Name "OpenSSH-Server-In-TCP" -ErrorAction SilentlyContinue | Select-Object Name, Enabled)) { Write-Output "防火墙规则'OpenSSH-Server-In-TCP'不存在，正在创建..." New-NetFirewallRule -Name 'OpenSSH-Server-In-TCP' -DisplayName 'OpenSSH Server (sshd)' -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22 } else { Write-Output "防火墙规则'OpenSSH-Server-In-TCP'已存在。" }这条命令会检查是否存在允许SSH连接（默认端口22）的入站规则，如果不存在则创建它。
4. 测试SSH连接
完成以上步骤后，就可以测试SSH连接是否正常工作了。你可以先测试本地连接：
ssh localhost第一次连接时，系统会询问是否信任该主机，输入"yes"继续。如果一切正常，你应该能看到类似这样的提示：
The authenticity of host 'localhost (::1)' can't be established. ECDSA key fingerprint is SHA256:[一串指纹]. Are you sure you want to continue connecting (yes/no/[fingerprint])?输入yes后，如果看到命令行提示符变成类似这样的格式，说明SSH连接成功：
[你的用户名]@[计算机名]要退出SSH会话，只需输入：
exit5. 解决VSCode中的SSH报错
现在回到最初的问题 - VSCode报错"An SSH installation couldn't be found"。完成上述OpenSSH安装和配置后，这个问题应该已经解决了。但为了确保万无一失，让我们再做几个检查：
- 重启VSCode：安装完OpenSSH后，关闭并重新打开VSCode
- 检查Remote-SSH扩展：确保已安装"Remote - SSH"扩展
- 验证SSH路径：在VSCode设置中搜索"ssh path"，确认指向正确的SSH可执行文件（通常是
C:\Windows\System32\OpenSSH\ssh.exe）
如果仍然有问题，可以尝试在VSCode的终端中直接运行SSH命令，看看是否能连接远程服务器：
ssh username@remote-server-address6. 高级配置与故障排除
对于更复杂的场景或遇到特殊问题，这里有一些额外的技巧：
6.1 修改SSH默认端口
如果出于安全考虑需要更改默认SSH端口（22），可以编辑SSH服务器的配置文件：
- 用记事本（管理员权限）打开
C:\ProgramData\ssh\sshd_config - 找到
#Port 22这一行，删除#号并修改端口号 - 保存文件并重启SSH服务：
Restart-Service sshd别忘了在防火墙中更新或添加对应的端口规则。
6.2 密钥认证配置
相比密码认证，SSH密钥认证更安全方便。设置步骤如下：
- 在PowerShell生成密钥对：
ssh-keygen -t rsa -b 4096- 将公钥复制到远程服务器的
~/.ssh/authorized_keys文件中 - 如果需要，可以在
sshd_config中禁用密码认证：
PasswordAuthentication no6.3 常见错误及解决方案
| 错误现象 | 可能原因 | 解决方案 |
|---|---|---|
| 连接超时 | 防火墙阻止/网络问题 | 检查防火墙规则，确认端口开放 |
| 权限被拒绝 | 认证失败 | 检查用户名/密码，或密钥配置 |
| 连接被拒绝 | SSH服务未运行 | 使用Get-Service sshd检查服务状态 |
7. 提升SSH使用体验的小技巧
经过多次项目实践，我总结了一些能显著提升Windows下SSH开发体验的技巧：
- 使用VSCode的Remote-SSH扩展：它允许你直接在远程服务器上开发，就像在本地一样
- 配置SSH Config文件：在
C:\Users\你的用户名\.ssh\config中定义常用连接，避免每次输入完整命令 - 保持OpenSSH更新：定期检查并更新OpenSSH组件：
Get-WindowsCapability -Online | Where-Object Name -like 'OpenSSH*' | Add-WindowsCapability -Online- 使用Windows Terminal：比传统PowerShell或CMD提供更好的SSH终端体验
- 启用SSH代理转发：在
sshd_config中设置AllowAgentForwarding yes，方便在多台服务器间跳转
在最近的一个跨平台开发项目中，正是这些SSH配置技巧让我能够高效地在Windows本地和多个Linux服务器之间无缝切换，大大提升了开发效率。特别是在调试分布式系统时，能够快速在不同节点间切换并保持一致的开发环境，这种体验是传统FTP+远程桌面无法比拟的。
