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










