使用VS Code远程开发树莓派等嵌入式设备

1次阅读

vs code 远程开发树莓派需配置Remote-ssh扩展及树莓派端基础环境:启用SSH、设静态IP、安装必要工具、配置免密登录;本地安装插件后连接IP,即可远程编辑、调试、部署,无需桌面环境。

使用VS Code远程开发树莓派等嵌入式设备

VS Code 远程开发树莓派非常实用,关键在于让编辑、调试和部署在本地流畅进行,而实际运行和编译发生在树莓派上。核心是 VS Code 的 Remote-SSH 扩展,配合树莓派端的基础环境配置,无需桌面环境也能高效工作。

树莓派端:基础准备不可少

确保树莓派已联网并能通过 SSH 访问。推荐使用 Raspberry Pi OS Lite(无桌面版),更轻量、更稳定。

  • 启用 SSH:首次启动后,在 boot 分区新建空文件 ssh(无后缀);或运行 sudo systemctl enable ssh && sudo systemctl start ssh
  • 设好静态 IP 或记牢当前 IP(用 hostname -I 查)
  • 安装必要工具sudo apt update && sudo apt install -y openssh-server git build-essential python3-pip
  • (可选但推荐)配置免密登录:在本地生成密钥对(ssh-keygen),再用 ssh-copy-id pi@xxx.xxx.xxx.xxx 推送公钥

VS Code 端:装插件 + 连设备

在本地 windows/macos/linux 上的 VS Code 中:

  • 安装官方扩展:Remote – SSHmicrosoft 出品,图标是两台连接的电脑
  • Ctrl+Shift+P(Win/Linux)或 Cmd+Shift+P(macOS),输入 Remote-SSH: Connect to Host…
  • 选择 Add New SSH Host…,填入:pi@192.168.1.123(替换为你的树莓派 IP)
  • VS Code 会自动写入配置到 ~/.ssh/config,之后可一键连接

远程打开项目 & 安装开发支持

连接成功后,VS Code 窗口右下角状态栏会显示当前 SSH 目标(如 pi@raspberrypi)。此时所有操作都发生在树莓派上:

使用VS Code远程开发树莓派等嵌入式设备

NameGPT

免费的名称生成器,AI驱动在线生成企业名称及Logo

使用VS Code远程开发树莓派等嵌入式设备 104

查看详情 使用VS Code远程开发树莓派等嵌入式设备

  • 点击 File → Open Folder…,浏览树莓派上的路径(例如 /home/pi/my-embedded-project
  • 首次打开时,VS Code 会自动在树莓派上部署一个轻量服务端(vscode-server),耗时约 10–30 秒,耐心等待
  • 如需 C/C++ 开发,再装 C/C++ 插件(它会自动在远程端同步安装对应组件)
  • python 项目?直接用 Python 插件,解释器自动识别树莓派上的 /usr/bin/python3 或虚拟环境

调试与日常协作小技巧

远程开发不是“只看不碰”,调试和文件交互同样顺滑:

  • 断点调试 C/C++:配好 launch.json,用 gdbserver 或本地 gdb(需交叉调试时另配 toolchain)
  • Python 调试:直接 F5,进程在树莓派运行,VS Code 显示变量、调用、终端输出一应俱全
  • 快速传文件:右键资源管理器中文件 → Download from Remote…;或拖拽本地文件到远程文件夹(自动上传)
  • 终端即树莓派终端:集成终端(Ctrl+`)默认就是 ssh shell,makesystemctljournalctl 都能直接敲

基本上就这些。整个过程不依赖树莓派是否有桌面、是否插显示器,只要通电联网 SSH 可达,就能当成一台远端 Linux 工作站来用。对嵌入式学习、iot 原型开发特别友好。

text=ZqhQzanResources