vscode远程ssh连接树莓派
时间: 2025-07-15 13:12:54 浏览: 5
### 使用VSCode通过SSH远程连接树莓派的配置教程
#### 1. 安装必要的软件
在开始之前,需要确保你的开发环境已经准备好。首先,在Windows主机上安装Visual Studio Code (VSCode) 和 Remote-SSH 扩展[^1]。此外,还需要在树莓派上安装并运行 SSH 服务[^2]。
#### 2. 配置SSH连接
完成上述安装后,打开 VSCode 的左侧菜单栏中的“远程资源管理器”。点击 SSH TARGETS 右边的齿轮图标,选择 `.ssh/config` 文件进行编辑。在该文件中添加以下内容,并根据实际情况修改:
```plaintext
Host pi
HostName 192.168.0.103
User pi
Port 22
```
- `Host`:为远程设备起一个名字(例如 `pi`)。
- `HostName`:填入树莓派的 IP 地址。
- `User`:填入树莓派的用户名(通常为 `pi`)。
- `Port`:默认为 22,无需更改。
#### 3. 连接到树莓派
保存 `.ssh/config` 文件后,返回 VSCode 的“远程资源管理器”,从 SSH TARGETS 列表中选择你刚刚配置的树莓派名称(如 `pi`),点击连接。如果这是第一次连接,可能会提示接受 SSH 密钥指纹,选择接受即可[^3]。
#### 4. 下载并安装VSCode服务器
当 VSCode 尝试连接到树莓派时,它会自动下载并安装一个服务器组件到树莓派上。如果你遇到问题(例如卡在“Downloading with wget”),可以手动下载对应的 VSCode 服务器压缩包。访问以下 URL 并替换 `COMMIT_ID` 为你当前使用的 VSCode 版本号:
```plaintext
https://update.code.visualstudio.com/commit:COMMIT_ID/server-linux-x64/stable
```
下载完成后,将压缩包上传到树莓派并解压到指定目录[^4]。
#### 5. 编写和运行Python程序
连接成功后,你可以在 VSCode 中像本地开发一样编写 Python 程序。所有的代码编辑、调试和运行都会在树莓派上执行,而你只需在 Windows 主机上操作即可[^1]。
#### 6. 建议和注意事项
- 确保树莓派和 Windows 主机处于同一网络环境中。
- 如果树莓派的 IP 地址发生变化,请更新 `.ssh/config` 文件中的 `HostName`。
- 在使用过程中,注意树莓派的性能限制,避免运行过于复杂的任务[^1]。
```python
# 示例:简单的 Python 程序
print("Hello, Raspberry Pi!")
```
阅读全文
相关推荐

















