使用 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 目录，重新连接会自动重装服务端组件。
