需安装Remote-SSH扩展、配置~/.ssh/config、通过命令面板连接主机、配置免密登录、最后在远程目录打开项目。
如果您希望在本地计算机上使用 VSCode 编辑器直接编辑远程服务器上的代码，则需要通过 SSH 协议建立安全连接并加载远程工作区。以下是实现该目标的具体步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、安装 Remote-SSH 扩展
Remote-SSH 是 VSCode 官方提供的扩展，用于支持通过 SSH 连接到远程主机并启动远程开发环境。它会自动在远程服务器上部署 VS Code Server，使本地编辑器与远程文件系统、终端和调试器无缝协同。
1、打开 VSCode，点击左侧活动栏的扩展图标（或按快捷键 ⇧⌘X）。
2、在扩展搜索框中输入 Remote-SSH，找到由 Microsoft 发布的官方扩展。
3、点击“安装”按钮，等待扩展下载并启用。
二、配置 SSH 主机连接信息
VSCode 依赖本地的 OpenSSH 配置文件（~/.ssh/config）来识别远程主机地址、端口、用户及密钥路径。正确配置后，VSCode 可以直接从该文件读取连接参数，无需每次手动输入。
1、在终端中执行 mkdir -p ~/.ssh 确保 SSH 目录存在。
2、使用文本编辑器打开或新建 ~/.ssh/config 文件。
3、在文件中添加如下格式的主机条目：
Host myserver
HostName 192.168.1.100
User ubuntu
Port 22
IdentityFile ~/.ssh/id_rsa
三、通过命令面板连接远程主机
VSCode 提供图形化入口快速触发远程连接流程。连接成功后，窗口右下角状态栏将显示当前连接的主机名，并自动在远程服务器上部署 VS Code Server。
1、按下快捷键 ⇧⌘P 打开命令面板。
2、输入并选择 Remote-SSH: Connect to Host...。
3、从列表中选择已配置的主机名（如 myserver）。
4、等待连接建立，若首次连接，VSCode 将自动上传并安装远程服务端组件。
四、使用免密登录验证 SSH 连接
若连接过程中提示输入密码，说明尚未配置 SSH 公钥认证。为保障远程开发流程顺畅，应确保本地私钥可被 VSCode 正确调用，且远程服务器的 authorized_keys 中已写入对应公钥。
1、在本地终端运行 ssh-keygen -t ed25519 -C "your_email@example.com" 生成新密钥对。
2、执行 ssh-copy-id -i ~/.ssh/id_ed25519.pub ubuntu@192.168.1.100 将公钥复制到服务器。
3、测试连接：ssh -T myserver，确认返回欢迎信息且无密码提示。
五、在远程会话中打开项目文件夹
连接建立后，VSCode 的资源管理器将反映远程服务器的文件系统结构。此时所有编辑、保存、终端命令和调试操作均直接作用于远程环境，本地仅作为显示与交互前端。
1、点击 VSCode 左侧资源管理器中的“远程资源管理器”图标（地球形状）。
2、在“SSH TARGETS”区域找到已连接的主机名，右键选择 Connect to Folder...。
3、在弹出的远程路径输入框中填写目标目录，例如 /home/ubuntu/myproject。
4、按回车确认，VSCode 将在该路径下加载工作区，并启动远程扩展宿主进程。
