如何用VS Code远程连接和开发树莓派(Raspberry Pi)

使用 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 会在配置中添加一段内容：

算家云

高效、便捷的人工智能算力服务平台

228 查看详情

Host raspberry-pi
    HostName 192.168.1.100
    User pi

4. 连接到树莓派

再次点击左下角，选择 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++ 项目，体验都很自然。

以上就是如何用VS Code远程连接和开发树莓派(Raspberry Pi)的详细内容，更多请关注其它相关文章！