如何使用VS Code远程连接并开发树莓派项目

使用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 会在右下角弹出窗口，开始连接。首次连接会提示你确认主机指纹，选择“是”继续。

青泥AI

青泥学术AI写作辅助平台

302

查看详情

接着输入树莓派用户的密码（默认用户是 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、机器人、媒体中心等树莓派项目。

以上就是如何使用VS Code远程连接并开发树莓派项目的详细内容，更多请关注php中文网其它相关文章！