通过 SSH 使用 Visual Studio Code 进行开发

本指南将引导你如何从本地计算机通过 SSH 使用 Visual Studio Code(VS Code)连接你的开发板(例如运行 Ubuntu 的 RB3 Gen-2)。

​

前提条件

• 开发板已安装最新的 Ubuntu 镜像:
  • Qualcomm Dragonwing RB3 Gen 2 Vision Kit
  • IQ-9075 EVK
• 开发板已连接互联网。

​

步骤 1 — 启用 SSH / 查找 IP 地址

1. 使用串口连接设备,参见 Qualcomm 文档:在设备上配置 Ubuntu(该文档面向 RB3,但同样适用于 Rubik Pi 3)。
2. 通过控制台登录,默认用户名为 ubuntu,默认密码也是 ubuntu。
3. 确保网络已设置好(以太网或 Wi-Fi)。
4. 查找开发板的 IP 地址。例如通过:
   sudo apt update && sudo apt install -y net-tools
   ifconfig | grep -Eo 'inet (addr:)?([0-9]*\.){3}[0-9]*' | grep -Eo '([0-9]*\.){3}[0-9]*' | grep -v '127.0.0.1'
   # 192.168.1.253
   

​

步骤 2 — 在 VS Code 中安装/启用 Remote ‑ SSH 扩展

在你的本地计算机上:

1. 打开 VS Code。
2. 进入 Extensions(扩展)。
3. 搜索 Remote ‑ SSH(由 Microsoft 提供)并安装。

​

步骤 3 — 在 VS Code 中将开发板添加为 SSH 主机

1. 在 VS Code 中打开命令面板(F1,macOS 上为 Command+Shift+P,Windows/Linux 上为 Ctrl+Shift+P)。
2. 运行 Remote‑SSH: Add New SSH Host...
3. 输入 SSH 连接字符串,例如:
   ubuntu@board-ip-address
   
   *可选:*如果你使用密钥,可以包含身份文件:
   ssh -i ~/.ssh/id_rsa_board user@board-ip-address
   
4. 选择要使用的 SSH 配置文件(通常是 ~/.ssh/config)。VS Code 会为你的开发板插入一个条目。 配置示例片段:
   Host my-board
       HostName 192.168.1.100
       User ubuntu
       IdentityFile ~/.ssh/id_rsa_board
   

​

步骤 4 — 通过 VS Code 连接到开发板

1. 在 VS Code 中,再次打开命令面板 → Remote‑SSH: Connect to Host...
2. 选择你的主机(例如 ubuntu@board-ip-address 或你在 SSH 配置中指定的名称)。
3. 如出现提示,选择远程主机的平台。
4. 稍等片刻后,VS Code 会自动将 VS Code Server 安装到开发板上。状态会显示在底部状态栏中。
5. 连接成功后,你可以使用 File → Open Folder… 浏览开发板上的文件,打开终端(这些终端将在开发板上运行),并根据需要在远程主机上安装扩展。

​

故障排除

• **VS Code Server 占用过多 RAM:**在远程主机上运行大量 VS Code 扩展可能消耗大量内存,导致内存不足(OOM)错误和随机网络断连
  • **解决方案:**在远程主机上禁用或有选择地启用扩展,以降低内存占用
• **SSH 连接失败:**开发板不可达 / IP 错误 / SSH 未运行
  • **解决方案:**检查网络,从终端运行 ssh ubuntu@IP,并通过串口连接验证开发板的网络工具已更新且工作正常,例如
    sudo apt update && sudo apt install -y net-tools
    ifconfig
    
• **主机平台检测不正确:**VS Code 猜测错误(例如 ARM 与 x86)
  • **解决方案:**在 VS Code 设置中手动设置 remote.SSH.remotePlatform

​

可选:使用基于 SSH 密钥的身份验证

为避免输入密码:

1. 在本地计算机上,如果还没有 SSH 密钥对,先生成一个:
   ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa_board
   
2. 将公钥添加到你的开发板:
   ssh-copy-id -i ~/.ssh/id_rsa_board.pub user@board-ip-address
   
3. 确认可以无需密码即可通过 SSH 登录。
4. 更新你的 VS Code SSH 配置以引用此密钥(如步骤 3 所述)。