目录
一、前置准备：两端环境配置
1.1 树莓派端配置（关键步骤）
① 确保树莓派联网
② 开启SSH服务（必须）
③ 获取树莓派IP地址
④ 确认用户名/密码
1.2 电脑端配置
① 安装VS Code
② 安装Remote - SSH插件和python插件
二、VS Code配置SSH连接树莓派
2.1 编辑Vscode SSH配置文件
2.2 连接树莓派（核心步骤）
三、远程开发实操：编辑文件+执行命令
3.1 打开树莓派文件目录
3.2 打开远程终端
3.3 安装远程开发扩展（可选）
总结
前言：作为一名嵌入式/物联网开发者，树莓派是常用的开发板，但直接在树莓派上编写代码体验较差。借助VS Code的Remote - SSH插件，我们可以在电脑上远程操控树莓派，享受本地IDE的流畅体验。本文整理了从环境准备到实操连接、优化配置的完整流程，新手也能轻松上手！
适用场景：树莓派OS（Raspbian）/Ubuntu系统、电脑端Windows/macOS/Linux通用
核心原理：通过SSH协议建立电脑与树莓派的局域网连接，实现文件编辑、终端命令执行、代码调试等远程操作。
一、前置准备：两端环境配置
远程连接的前提是树莓派和电脑完成基础配置，重点是开启SSH服务和确保同网。
1.1 树莓派端配置（关键步骤）
① 确保树莓派联网
将树莓派与电脑连接到同一个路由器/热点（有线、无线均可），这是局域网连接的基础。
② 开启SSH服务（必须）
SSH是远程连接的核心协议，树莓派默认关闭，需手动开启，提供3种方法适配不同场景：
方法1（图形界面，有屏幕）：树莓派桌面 → 左上角【开始菜单】→ 【首选项】→ 【Raspberry Pi Configuration】→ 【Interfaces】→ 勾选【SSH】→ 点击【OK】。
方法2（命令行，有屏幕/已串口登录）：打开树莓派终端，输入命令
sudo raspi-config→ 选择【3 Interface Options】→ 【P2 SSH】→ 选【Yes】启用 → 按回车确认，退出配置工具。方法3（无屏初始化，新手推荐）：树莓派断电，取出SD卡插入电脑，在SD卡的【boot】分区（Windows可直接识别）新建一个空白文件，命名为
ssh（无后缀名），插回树莓派开机，系统会自动开启SSH。
③ 获取树莓派IP地址
电脑需要通过IP地址定位树莓派，获取方式：
树莓派终端执行命令：
hostname -I或ifconfig，找到eth0（有线）或wlan0（无线）对应的【inet】字段，例如192.168.31.100（记下来，后续要用）。
④ 确认用户名/密码
树莓派默认用户：
pi，默认密码：raspberry（建议首次登录后修改，避免安全风险：终端输入passwd，按提示输入新密码）。
1.2 电脑端配置
① 安装VS Code
从VS Code官网下载对应系统版本：https://code.visualstudio.com/，安装完成后打开。
② 安装Remote - SSH插件和python插件
打开VS Code → 左侧【扩展】栏（快捷键：Ctrl+Shift+X）→ 搜索【Remote - SSH】等→ 选择微软官方插件（作者：Microsoft）→ 点击【安装】。
插件安装完成后，左侧会新增【远程资源管理器】图标，说明插件生效。
二、VS Code配置SSH连接树莓派
完成前置准备后，开始配置连接信息，步骤如下：
2.1 编辑Vscode SSH配置文件
打开VS Code，按快捷键【F1】（或【Ctrl+Shift+P】），弹出命令面板。
在命令面板中输入：
Remote-SSH: Open SSH Configuration File...，按回车。Remote-SSH: Open SSH Configuration File...选择一个配置文件路径（推荐默认路径，如Windows：
C:\Users\你的用户名\.ssh\config；macOS/Linux：~/.ssh/config）。在配置文件中添加树莓派的连接信息，复制以下模板并修改对应参数：
# 树莓派连接别名（自定义，方便记忆，如raspberrypi） Host raspberrypi HostName 192.168.31.100 # 替换为你的树莓派IP地址 User pi # 替换为你的树莓派用户名（默认pi） Port 22 # SSH默认端口22，未修改过则无需改动 # 可选：Windows若使用OpenSSH，可指定私钥路径（免密登录时用） # IdentityFile C:\Users\你的用户名\.ssh\id_rsa
按【Ctrl+S】保存配置文件。
2.2 连接树莓派（核心步骤）
再次按【F1】打开命令面板，输入：
Remote-SSH: Connect to Host...，按回车。在弹出的列表中，选择刚才配置的别名（如raspberrypi）。
首次连接会弹出【选择系统类型】的提示，树莓派基于Linux系统，选择【Linux】。
弹出密码输入框，输入你的树莓派密码（默认raspberry），按回车。
等待连接：底部状态栏会显示【SSH: raspberrypi】，且颜色变为绿色，说明连接成功！
注意：首次连接可能会提示“是否信任主机”，点击【继续】即可。
方法2：
三、远程开发实操：编辑文件+执行命令
连接成功后，就可以像操作本地文件一样操控树莓派了，常用操作如下：
3.1 打开树莓派文件目录
左侧点击【资源管理器】图标（快捷键【Ctrl+Shift+E】）。
点击【打开文件夹】，在弹出的输入框中输入树莓派的目录路径（如默认用户目录：
/home/pi），按回车。再次输入树莓派密码确认，稍等片刻后，即可看到树莓派该目录下的所有文件，双击文件即可在VS Code中编辑。
3.2 打开远程终端
远程终端可直接执行树莓派的Linux命令，打开方式：
按快捷键【Ctrl+`】（反引号，在Tab键上方），VS Code底部会弹出终端窗口，此时终端前缀为
pi@raspberrypi:~$，说明已成功连接树莓派，可执行任意Linux命令（如ls查看文件、python3 test.py运行Python脚本）。
3.3 安装远程开发扩展（可选）
若需要开发Python、C/C++等语言，需将对应的扩展安装到树莓派端（而非本地），否则无法正常语法高亮和调试：
左侧【扩展】栏，搜索需要的扩展（如【Python】、【C/C++】）。
找到扩展后，点击【Install on SSH: raspberrypi】（而非【安装】，【安装】是安装到本地）。
等待安装完成，扩展会自动生效，即可在远程环境中使用语法提示、调试等功能。
总结
本文详细讲解了VS Code远程连接树莓派的完整流程，核心步骤可总结为：开启树莓派SSH服务→电脑安装Remote - SSH插件→配置SSH连接信息→连接树莓派→（可选）配置免密登录。按照步骤操作，新手也能快速上手，从此摆脱树莓派小屏幕和键盘的限制，享受本地IDE的开发体验！
如果本文对你有帮助，欢迎点赞、收藏、关注，后续会分享更多树莓派开发技巧～
留言区：如果遇到其他问题，欢迎在评论区留言，看到会及时回复！
