VSCode远程连接：SSH开发环境搭建

使用VSCode通过Remote-SSH插件远程开发，需本地安装VSCode和SSH客户端，远程服务器开启SSH服务，并配置~/.ssh/config文件添加主机信息，如Host、HostName、User等；通过远程资源管理器连接目标主机，首次连接选择系统类型，确保私钥权限为600，成功后VSCode自动部署远程服务；可打开远程文件夹并使用IntelliSense、Git、终端等功能；建议配置SSH密钥免密登录，在~/.ssh/config中添加ServerAliveInterval和TCPKeepAlive保持连接稳定，按需在远程端安装语言扩展，并在项目中使用.vscode/settings.json设置远程专属配置，实现高效稳定的远程开发体验。

使用VSCode通过SSH远程连接服务器进行开发，是一种高效、灵活的编码方式。尤其适合需要在远程Linux服务器上调试程序或维护项目的场景。借助Remote-SSH插件，你可以在本地编辑器中操作远程文件，享受和本地开发几乎一致的体验。

安装必要组件

要实现远程开发，首先要确保本地和远程环境都满足基本条件：

• 本地安装VSCode：前往官网下载并安装最新版Visual Studio Code
• 安装Remote-SSH扩展：打开VSCode，在扩展市场中搜索“Remote - SSH”并安装（由Microsoft提供）
• 本地支持SSH客户端：Windows 10及以上通常自带OpenSSH客户端，macOS和Linux默认支持。可通过终端运行ssh -V验证是否可用
• 远程服务器开启SSH服务：确保目标服务器已安装并运行OpenSSH服务（如Ubuntu/Debian使用sudo systemctl status ssh检查）

配置SSH连接信息

为了让VSCode顺利连接远程主机，需先配置SSH连接参数：

• 打开VSCode左侧活动栏的“远程资源管理器”图标，点击“SSH Targets”下的“+”添加新主机
• 输入连接命令，例如：ssh username@hostname -p port（若使用非标准端口）
• 该操作会自动修改~/.ssh/config文件，也可手动编辑此文件添加如下内容：

保存后，即可在VSCode的远程资源管理器中看到“myserver”主机名。

建立连接并打开远程项目

点击刚刚添加的主机名，VSCode会弹出一个新窗口开始连接流程：

豆包AI编程

豆包推出的AI编程助手

483

查看详情

• 首次连接时会提示选择远程系统的类型（Linux/macOS/Unix），选择对应项以正确加载开发环境
• 如果使用密钥认证，请确保私钥权限设置合理（chmod 600 ~/.ssh/id_rsa）
• 连接成功后，VSCode会在远程服务器上自动部署一个轻量级的“VS Code Server”用于文件访问、调试等支持
• 按执行“Remote-SSH: Open Folder”命令，输入路径如/home/devuser/project

此时编辑器已加载远程目录，可正常使用IntelliSense、Git、终端等功能。

优化使用体验

为提升稳定性和效率，建议进行以下设置：

• 使用SSH密钥免密登录：生成密钥对并将公钥放入远程服务器~/.ssh/authorized_keys
• 保持连接稳定：在~/.ssh/config中添加：

• 配置远程扩展：部分语言支持需在远程端安装扩展（如Python、Pylance），VSCode会提示自动安装到远程环境
• 使用远程工作区设置：项目根目录下创建.vscode/settings.json，定义远程专属配置

基本上就这些。一旦配置完成，每次只需从远程资源管理器选择主机即可快速进入开发状态，无需反复上传文件或切换终端。整个过程不复杂但容易忽略细节，比如权限问题或网络限制，只要基础SSH通了，VSCode远程开发就能顺畅运行。

以上就是VSCode远程连接：SSH开发环境搭建的详细内容，更多请关注php中文网其它相关文章！