需通过SSH配置密钥、安装Remote-SSH扩展、设置SSH配置文件、自动或手动部署VSCode Server，才能在本地VSCode中编辑调试远程代码。
如果您希望在本地 VSCode 编辑器中直接编辑、调试和运行远程服务器上的代码，则需要通过 SSH 建立安全连接。以下是实现该目标的具体操作流程：
本文运行环境：MacBook Air，macOS Sequoia。
一、配置本地 SSH 密钥与服务器访问权限
该步骤旨在为本地机器生成身份凭证，并将公钥部署至远程服务器，从而实现免密码登录，这是 VSCode 远程 SSH 插件正常工作的前提条件。
1、打开终端，执行命令 ssh-keygen -t ed25519 -C "your_email@example.com" 生成新的密钥对。
2、按回车确认默认保存路径，随后可选择性输入密钥密码（留空则不设密码）。
3、执行 ssh-copy-id user@server_ip 将公钥自动复制到远程服务器的 ~/.ssh/authorized_keys 文件中。
4、运行 ssh user@server_ip 验证是否能无密码登录成功。
二、安装并启用 Remote-SSH 扩展
VSCode 本身不内置远程连接能力，需依赖官方提供的 Remote-SSH 扩展来建立与远程主机的通信通道，并加载远程工作区。
1、在 VSCode 左侧活动栏点击扩展图标（或按 ⇧⌘X），在搜索框中输入 Remote-SSH。
2、从搜索结果中选择由 Microsoft 发布的 Remote - SSH 扩展，点击“安装”按钮。
3、安装完成后，重启 VSCode 或点击“重新加载”提示按钮使扩展生效。
三、创建并连接远程 SSH 配置文件
VSCode 通过 ~/.ssh/config 文件或内置的 SSH 配置界面管理远程主机信息，确保连接参数准确且可复用。
1、按下 ⇧⌘P 打开命令面板，输入并选择 Remote-SSH: Connect to Host...。
2、在弹出选项中选择 Configure SSH Hosts...，然后选择 Open SSH Configuration File...。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
3、在打开的 config 文件末尾添加如下内容：
Host my-server
HostName 192.168.1.100
User ubuntu
IdentityFile ~/.ssh/id_ed25519
四、在远程服务器上启动 VSCode Server
首次连接时，Remote-SSH 扩展会自动在远程服务器下载并部署 VSCode Server 组件，该组件负责处理文件系统访问、进程管理及调试协议转发。
1、再次使用 ⇧⌘P 打开命令面板，选择 Remote-SSH: Connect to Host...。
2、从列表中选择刚配置的 my-server 条目。
3、等待终端输出显示 Installing VS Code Server，并最终进入远程窗口状态栏显示服务器 IP 地址。
五、手动触发远程服务器端 VSCode Server 安装
当自动安装失败（例如因网络策略拦截或权限不足），可手动在服务器上执行安装脚本，绕过客户端下载限制。
1、通过终端登录远程服务器，执行命令：curl -fsSL https://code.visualstudio.com/sha/download?build=stable&os=linux-x64 | tar -xzf - -C $HOME/.vscode-server/bin/。
2、进入 $HOME/.vscode-server/bin/ 目录，确认存在以 commit ID 命名的子目录。
3、返回本地 VSCode，重新发起连接请求，扩展将检测到已存在的 server 实例并直接复用。
