使用 VS Code 通过 Remote - SSH 插件远程连接树莓派，可在本地实现接近原生的开发体验。1. 确保树莓派已安装 Raspberry Pi OS、启用 SSH 并获取 IP 地址；首次启用 SSH 可在 boot 分区创建空文件 ssh。2. 在本地电脑安装 VS Code 及官方 Remote - SSH 插件。3. 配置 SSH 连接信息：在 VS Code 中添加主机 ssh pi@192.168.1.100，保存至配置文件，自动生成 Host 别名。4. 点击左下角绿色箭头选择目标主机连接，首次需输入密码并信任指纹，VS Code 自动安装服务端组件。5. 连接成功后打开远程目录，像本地一样编辑、调试代码，终端命令均在树莓派执行，支持硬件控制如 GPIO 和摄像头。6. 可选优化：配置 SSH 密钥免密登录、修改 Shell 类型或指定非标准端口提升效率。整个流程适用于 Python、Node.js、C/C++ 等项目，网络稳定时体验流畅自然。
使用 VS Code 远程连接树莓派进行开发，可以让你在本地电脑上获得接近本地开发的体验，同时代码直接运行在树莓派上。整个过程依赖于 VS Code 的 Remote - SSH 插件，操作简单且高效。
1. 准备工作：确保树莓派可远程访问
要通过 SSH 连接树莓派，需先完成以下设置：
- 树莓派已安装 Raspberry Pi OS（建议使用完整版或 lite 版）
- 树莓派和你的电脑处于同一局域网
- 启用树莓派的 SSH 服务（默认未开启）
- 获取树莓派的 IP 地址（可在路由器管理页面查看，或使用
arp -a命令查找）
启用 SSH 的方法（首次设置）：
- 将 SD 卡插入电脑，在
boot分区根目录创建一个空文件，命名为ssh（无扩展名） - 插入 SD 卡启动树莓派，系统会自动启用 SSH 并删除该文件
登录树莓派（默认用户名/密码）：
用户名：pi 密码：raspberry
2. 在本地电脑安装 VS Code 和 Remote - SSH 插件
在你的 Windows、macOS 或 Linux 电脑上：
- 下载并安装 VS Code
- 打开 VS Code，进入扩展商店搜索 Remote - SSH
- 安装由 Microsoft 提供的官方插件
3. 配置 SSH 连接信息
点击 VS Code 左下角的“绿色小箭头”（快速访问远程连接），选择 Remote-SSH: Connect to Host…，然后选择 Add New SSH Host…。
输入连接命令：
ssh pi@192.168.1.100
（将 IP 替换为你的树莓派实际地址）
选择保存到哪个 SSH 配置文件（一般选默认的 ~/.ssh/config）
完成后，VS Code 会在配置中添加一段内容：
Host raspberry-pi
HostName 192.168.1.100
User pi4. 连接到树莓派
再次点击左下角，选择 raspberry-pi，VS Code 将通过 SSH 连接。
- 首次连接会提示你确认指纹，并选择操作系统类型（Linux）
- 输入密码
raspberry - 等待 VS Code Server 在树莓派上自动安装（只需一次）
连接成功后，整个窗口变为远程上下文，底部状态栏显示绿色 SSH: raspberry-pi。
5. 开始远程开发
连接成功后，你可以：
- 按
Ctrl+Shift+P打开命令面板，运行 File: Open Folder - 选择树莓派上的项目路径，如
/home/pi/myproject - 像本地一样编辑、保存、调试代码
- 使用内置终端（Terminal → New Terminal），执行的命令都在树莓派上运行
例如运行 Python 脚本：
python3 main.py
可以直接控制 GPIO、摄像头等硬件。
6. 提高连接效率（可选优化）
避免每次输入密码：
- 在本地生成 SSH 密钥：
ssh-keygen - 将公钥复制到树莓派：
ssh-copy-id pi@192.168.1.100 - 之后连接无需密码
修改默认 shell（如使用 zsh）：
- 在
~/.ssh/config中添加：RequestTTY force
端口非默认 22 时：
Host raspberry-pi
HostName 192.168.1.100
User pi
Port 2222基本上就这些。只要网络稳定，VS Code + Remote SSH 能让你流畅地在树莓派上开发，无论是 Python、Node.js 还是 C/C++ 项目，体验都很自然。
