需通过SSH连接远程云服务器以在VSCode中编辑调试代码，操作包括：一、安装Remote-SSH扩展并重启；二、配置~/.ssh/config主机信息；三、用命令面板连接主机；四、配置密钥免密登录；五、排查超时与端口错误。
如果您希望在本地 VSCode 编辑器中直接编辑、调试和运行部署在远程云服务器上的代码，则需通过 SSH 协议建立稳定安全的连接通道。以下是实现该目标的详细操作路径：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Remote-SSH 扩展
Remote-SSH 是 VSCode 官方提供的核心扩展，用于启用远程开发能力，它负责管理 SSH 连接、远程服务器端代理进程及文件同步逻辑。
1、打开 VSCode，点击左侧活动栏最下方的扩展图标（四个方块组成的图标）。
2、在扩展搜索框中输入 Remote-SSH。
3、在搜索结果中找到由 Microsoft 发布的 Remote - SSH 扩展，点击“安装”按钮。
4、安装完成后，重启 VSCode 以确保扩展完全加载。
二、配置 SSH 主机连接信息
VSCode 依赖本地 ~/.ssh/config 文件或内置连接面板生成可识别的主机条目，该配置定义了目标服务器地址、端口、用户身份及密钥路径等关键参数。
1、在终端中执行 mkdir -p ~/.ssh 确保 SSH 配置目录存在。
2、使用命令 nano ~/.ssh/config 打开配置文件。
3、写入如下格式内容（请替换为实际值）：
Host my-cloud-server
HostName 123.45.67.89
User ubuntu
Port 22
IdentityFile ~/.ssh/id_rsa_cloud
4、保存并退出编辑器，执行 chmod 600 ~/.ssh/config 设置安全权限。
三、通过命令面板触发远程连接
VSCode 提供图形化入口快速调用远程会话，避免手动输入连接字符串，同时支持自动检测已配置主机。
1、按下 Cmd + Shift + P（Mac）或 Ctrl + Shift + P（Windows/Linux）打开命令面板。
2、输入 Remote-SSH: Connect to Host... 并回车。
3、从下拉列表中选择已配置的主机名 my-cloud-server。
4、首次连接时，VSCode 将自动在远程服务器上部署 server 启动脚本，并提示输入密码或确认密钥指纹。
四、使用 SSH 密钥免密登录（替代密码验证）
为提升连接安全性与自动化效率，应禁用密码登录，仅允许基于公钥的身份认证。此方式要求本地私钥与远程服务器 authorized_keys 文件严格匹配。
1、在本地终端运行 ssh-keygen -t ed25519 -C "your_email@example.com" 生成新密钥对。
2、执行 ssh-copy-id -i ~/.ssh/id_ed25519.pub ubuntu@123.45.67.89 将公钥上传至服务器。
3、登录服务器后，检查 ~/.ssh/authorized_keys 是否包含对应公钥行。
4、编辑服务器端 /etc/ssh/sshd_config，确认以下两行未被注释且值为 yes：
PubkeyAuthentication yes
PasswordAuthentication no
5、执行 sudo systemctl restart sshd 重载 SSH 服务配置。
五、处理连接超时与端口被拒错误
网络策略、防火墙规则或 SSH 服务状态异常常导致连接中断或拒绝，需分层排查链路各环节是否就绪。
1、在本地终端运行 ssh -T -p 22 ubuntu@123.45.67.89 测试基础连通性。
2、若返回 Connection refused，登录服务器控制台，执行 sudo systemctl status ssh 检查服务是否运行。
3、若返回 Connection timed out，检查云服务商安全组是否放行 TCP 端口 22。
4、在服务器上运行 sudo ufw status verbose 查看防火墙规则，必要时添加 sudo ufw allow OpenSSH。
