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

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 – SSH(microsoft 出品,图标是两台连接的电脑)
- 按 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)。此时所有操作都发生在树莓派上:
- 点击 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,make、systemctl、journalctl 都能直接敲
基本上就这些。整个过程不依赖树莓派是否有桌面、是否插显示器,只要通电联网 SSH 可达,就能当成一台远端 Linux 工作站来用。对嵌入式学习、iot 原型开发特别友好。