需通过VSCode Remote-SSH扩展实现本地编辑、树莓派运行调试:先在树莓派启用SSH并获取IP;再在Mac上安装Remote-SSH扩展;接着配置SSH主机信息;然后处理首次连接的密钥验证与密码输入;最后可选配置密钥登录提升安全性。

如果您希望在本地计算机上使用 VSCode 编辑代码,同时在树莓派上运行和调试程序,则需要通过 VSCode 的 Remote-SSH 扩展建立安全连接。以下是完成该连接的具体步骤:
本文运行环境:MacBook Air,macOS Sequoia。
一、在树莓派上启用 SSH 服务
VSCode 远程开发依赖 SSH 协议与目标设备通信,因此必须确保树莓派已开启 SSH 服务并允许远程登录。
1、将树莓派启动并接入同一局域网。
2、使用键盘和显示器直接登录树莓派系统,或通过已有的网络访问方式进入终端。
3、执行命令 sudo systemctl enable ssh 启用 SSH 服务开机自启。
4、执行命令 sudo systemctl start ssh 立即启动 SSH 服务。
5、运行 hostname -I 获取树莓派当前 IPv4 地址,例如 192.168.1.42。
二、在本地 VSCode 中安装 Remote-SSH 扩展
Remote-SSH 是微软官方提供的扩展,用于通过 SSH 协议连接远程主机并在其上运行 VSCode Server,实现无缝编辑体验。
1、打开本地 VSCode,在扩展面板中搜索 Remote - SSH。
2、点击安装按钮,等待扩展下载并完成激活。
3、安装完成后,左侧活动栏将出现远程连接图标(两个重叠的屏幕),点击即可进入远程资源管理器。
三、配置 SSH 连接信息
VSCode 需要明确知道如何通过 SSH 访问树莓派,包括 IP 地址、用户名和端口等参数,这些信息需写入本地 SSH 配置文件或通过界面添加。
1、点击左下角远程连接状态栏,选择 Connect to Host...。
2、选择 Configure SSH Hosts...,然后选择用户级配置文件(如 ~/.ssh/config)。
3、在打开的 config 文件末尾添加如下内容:
Host raspberrypi
HostName 192.168.1.42
User pi
Port 22
4、保存文件后,再次点击状态栏,选择 raspberrypi 并确认连接。
四、处理首次连接的密钥验证与密码输入
首次连接时,OpenSSH 会校验远程主机的公钥指纹以防止中间人攻击,同时要求提供用户凭证完成身份认证。
1、当弹出提示“Are you sure you want to continue connecting?”时,点击 Continue。
2、在弹出的输入框中输入树莓派用户的密码,例如默认用户 pi 的密码 raspberry。
3、VSCode 将自动在树莓派上部署 VSCode Server,并建立双向通信通道。
五、使用密钥对替代密码登录(可选增强方案)
为提升安全性与操作效率,可生成本地 SSH 密钥对,并将公钥复制至树莓派,从而免密登录。
1、在本地终端执行 ssh-keygen -t ed25519 生成新密钥对。
2、执行 ssh-copy-id pi@192.168.1.42 将公钥上传至树莓派。
3、修改 ~/.ssh/config 中对应 Host 段,添加一行:IdentityFile ~/.ssh/id_ed25519。
4、重新连接时将不再提示输入密码,而是自动使用密钥完成认证。










