使用VS Code SSH远程连接树莓Pi时提示:VS Code Server启动失败
针对你遇到的VS Code Remote Development连接树莓派失败的问题,我整理了几个针对性的解决方案,你可以一步步尝试:
1. 先更新树莓派系统包
2019年9月的Raspbian版本比较老旧,可能缺少VS Code Server运行所需的依赖库。先通过SSH连接到树莓派,执行以下命令更新系统:
sudo apt update && sudo apt full-upgrade -y sudo reboot
系统更新完成后,再尝试用VS Code连接,很多兼容性问题都能通过这个步骤解决。
2. 查看VS Code Server的详细日志
自动安装失败时,树莓派上会生成详细的日志文件,能帮你定位具体问题。SSH到树莓派后,查看最新的日志:
cd ~/.vscode-server/data/logs ls -lt # 按时间排序,找最新的日志文件 cat <最新日志文件名>
日志里通常会提示具体的错误原因,比如缺少某个依赖、权限不足等。
3. 手动部署VS Code Server
自动安装流程可能因为网络或系统兼容性出问题,手动部署更可靠:
- 在本地VS Code打开命令面板(快捷键
Ctrl+Shift+P),输入Remote-SSH: Show Local Command,复制里面的版本号(类似1.81.1或一串长哈希值)。 - 回到树莓派的SSH终端,下载对应arm架构的Server包:
把cd ~ wget https://update.code.visualstudio.com/commit:<你的版本号>/server-linux-armhf/stable<你的版本号>替换成刚才复制的内容,比如wget https://update.code.visualstudio.com/commit:6c3e3dba23e8fadc360aed75ce363ba185c49794/server-linux-armhf/stable - 解压包到VS Code Server的目录:
mkdir -p ~/.vscode-server/bin/<你的版本号> tar -xzf stable -C ~/.vscode-server/bin/<你的版本号> --strip-components=1 - 重启本地VS Code,再尝试连接主机。
4. 检查.vscode-server目录权限
有时候目录权限不正确会导致Server启动失败,执行以下命令修复权限:
sudo chown -R pi:pi ~/.vscode-server
确保这个目录及其子文件的所有者都是pi用户。
5. 更新本地VS Code及Remote扩展
旧版本的VS Code或Remote扩展可能和老系统存在兼容性问题:
- 把本地VS Code更新到最新版本;
- 在VS Code扩展商店里,找到
Remote Development扩展包,更新其中的所有子扩展(比如Remote-SSH、Remote-SSH: Editing Configuration Files等)。
6. 简化SSH配置测试
暂时简化你的SSH配置,排除配置文件的潜在问题:
把本地C:/Users/ttimo/.ssh/config改成:
Host raspberrypi HostName 192.168.2.6 User pi
然后在VS Code里选择raspberrypi主机,尝试用密码登录连接。如果能成功安装Server,再逐步加回IdentityFile配置,排查密钥相关的小问题。
内容的提问来源于stack exchange,提问作者Timo




