使用VS Code通过Remote-SSH插件远程连接树莓派,可在本地高效开发并直接在设备上运行调试代码。1. 确保树莓派启用SSH、获取IP并建议设静态IP;2. 本地安装VS Code及Remote-SSH扩展;3. 添加ssh pi@树莓派IP至SSH配置并连接;4. 连接后终端运行在树莓派,可安装Python等工具链;5. 打开项目文件夹编写代码,利用Python扩展实现运行与调试,文件实时保存在设备端。整个流程支持GPIO控制等IoT开发,体验接近本地。
使用 VS Code 远程连接树莓派进行开发,可以让你在本地享受完整的编辑体验,同时直接在树莓派上运行和调试代码。整个过程依赖于 VS Code 的
Remote - SSH
插件,以下是详细操作步骤。
1. 准备树莓派环境
确保你的树莓派已接入网络并启用 SSH 服务:
使用
启用 SSH(选择 Interface Options → SSH)
记下树莓派的 IP 地址,可通过
路由
器查看或在树莓派终端输入
建议配置静态 IP,避免每次连接时 IP 变化
确保树莓派已安装 OpenSSH 服务器:
如果从外部网络连接,可能需要设置端口转发或使用局域网直连方式。
2. 配置本地 VS Code 和 Remote-SSH 插件
在你的电脑上安装 VS Code,并添加远程开发支持:
打开 VS Code,进入扩展商店搜索
Remote - SSH
并安装
安装完成后,左侧活动栏会出现一个“远程资源管理器”图标(
显示器
加箭头)
点击该图标,或使用快捷键
打开命令面板
输入 “Remote-SSH: Connect to Host…” 并选择
3. 建立 SSH 连接
首次连接需手动添加主机信息:
在命令面板中选择 “Add New SSH Host…”
输入连接命令,格式为:
(将 IP 替换为你的树莓派地址)
选择保存到哪个 SSH 配置文件(默认即可)
随后会出现在左侧“远程资源管理器”的主机列表中
点击该主机条目,VS Code 会在右下角弹出窗口,开始连接。首次连接会提示你确认主机指纹,选择“是”继续。
php版微信js-sdk支付接口类
php版微信js-sdk支付接口类
下载
接着输入树莓派用户的密码(默认用户是
,密码是
,如果你没改过)。
4. 在树莓派上初始化开发环境
连接成功后,VS Code 界面会切换为远程上下文,底部状态栏变绿,显示当前连接的主机。
打开终端(Terminal → New Terminal),此时终端运行在树莓派上
可安装 Python、GCC、Node.
js
等开发工具,例如:
推荐安装 Pylint、Black 等工具提升
编码
体验
打开树莓派上的项目文件夹,例如:
,即可开始编辑。
5. 开发与调试示例(以 Python 为例)
在远程窗口中安装 Python 扩展(由 Microsoft 提供)
创建
文件,写入简单代码如控制 GPIO 或读取传感器
右键文件选择“在终端中运行 Python 文件”,或使用调试功能设置断点
所有文件保存都直接写入树莓派,无需手动同步
你还可以通过 SFTP 插件辅助传输大文件,但通常不需要,因为文件系统已直接挂载。
基本上就这些。只要网络稳定,远程开发体验几乎和本地无异,特别适合做 IoT、机器人、媒体中心等树莓派项目。
sudo raspi-confighostname -Isudo apt install openssh-serverCtrl+Shift+Pssh pi@192.168.1.100piraspberrysudo apt update && sudo apt install python3 python3-pip gcc/home/pi/my_projectmain.py