使用vscode通过ssh远程开发是提升效率的常用方式，尤其适合管理服务器项目或在本地编辑远程代码。配置简单，操作直观，只要掌握几个关键点就能快速上手。
SSH连接的基本配置
确保本地已安装OpenSSH客户端（windows 10以上默认支持，macOS和linux原生支持），然后打开VSCode，安装Remote – SSH扩展。
点击左下角绿色远程按钮，选择“Connect to Host…” → “Add New SSH Host”，输入：
ssh username@hostname -p port
例如：
ssh user@192.168.1.100 -p 22
按提示保存到SSH配置文件（通常是~/.ssh/config），之后该主机就会出现在远程资源管理器中。
免密登录设置（推荐）
避免每次输入密码，建议配置SSH密钥认证：
- 生成密钥对：
ssh-keygen -t rsa -b 4096 - 将公钥复制到远程主机：
ssh-copy-id user@hostname - 测试连接：直接
ssh user@hostname应无需密码
配置完成后，VSCode连接将自动使用密钥，体验更流畅。
管理多个远程主机
在~/.ssh/config中可定义多个Host别名，便于组织不同环境：
Host myserver
HostName 192.168.1.100
User deploy
Port 22
IdentityFile ~/.ssh/id_rsa_server
每增加一个Host，VSCode的远程面板都会显示对应条目，点击即可连接。
你还可以为不同项目设置专用密钥，避免权限混淆。
常见问题与解决
连接失败时，先检查以下几点：
- 远程主机SSH服务是否运行（
sudo systemctl status ssh） - 防火墙是否放行对应端口
- 用户是否有登录权限（查看
/etc/ssh/sshd_config中的AllowUsers） - 公钥是否正确写入远程用户的
~/.ssh/authorized_keys
VSCode连接时若卡在“Initializing VS Code Server”，可尝试删除远程家目录下的~/.vscode-server目录，重新连接会自动重装服务端组件。
基本上就这些。配置一次，后续都能像操作本地项目一样编辑远程文件，调试、终端、git全部可用，非常方便。