VSCode远程：SSH配置与管理

使用VSCode通过SSH远程开发是提升效率的常用方式，尤其适合管理服务器项目或在本地编辑远程代码。配置简单，操作直观，只要掌握几个关键点就能快速上手。

SSH连接的基本配置

确保本地已安装OpenSSH客户端（Windows 10以上默认支持，macOS和Linux原生支持），然后打开VSCode，安装Remote - SSH扩展。

点击左下角绿色远程按钮，选择“Connect to Host…” → “Add New SSH Host”，输入：

例如：

按提示保存到SSH配置文件（通常是~/.ssh/config），之后该主机就会出现在远程资源管理器中。

免密登录设置（推荐）

避免每次输入密码，建议配置SSH密钥认证：

• 生成密钥对：ssh-keygen -t rsa -b 4096
• 将公钥复制到远程主机：ssh-copy-id user@hostname
• 测试连接：直接ssh user@hostname应无需密码

配置完成后，VSCode连接将自动使用密钥，体验更流畅。

乾坤圈新媒体矩阵管家

新媒体账号、门店矩阵智能管理系统

17

查看详情

管理多个远程主机

在~/.ssh/config中可定义多个Host别名，便于组织不同环境：

每增加一个Host，VSCode的远程面板都会显示对应条目，点击即可连接。

你还可以为不同项目设置专用密钥，避免权限混淆。

常见问题与解决

连接失败时，先检查以下几点：

• 远程主机SSH服务是否运行（sudo systemctl status ssh）
• 防火墙是否放行对应端口
• 用户是否有登录权限（查看/etc/ssh/sshd_config中的AllowUsers）
• 公钥是否正确写入远程用户的~/.ssh/authorized_keys

VSCode连接时若卡在“Initializing VS Code Server”，可尝试删除远程家目录下的~/.vscode-server目录，重新连接会自动重装服务端组件。

基本上就这些。配置一次，后续都能像操作本地项目一样编辑远程文件，调试、终端、Git全部可用，非常方便。

以上就是VSCode远程：SSH配置与管理的详细内容，更多请关注php中文网其它相关文章！