remote-ssh连得上开发板≠能运行代码，因其不自动安装esptool/openocd等工具链，且低功耗板常无完整linux环境；需手动部署agent、封装烧录脚本、改用scp同步并单独验证串口/gdb通路。
能连上开发板 ≠ 能推代码跑起来——Remote-SSH 在低功耗开发板（如 ESP32、Raspberry Pi Pico、Nordic nRF52）上默认不工作，必须手动补全工具链和同步逻辑。
为什么 Remote-SSH 连得上但 run 不了 Python/C 代码
Remote-SSH 只负责建立终端通道，它不会自动安装 esptool、openocd、arm-none-eabi-gcc 或 uf2conv。开发板通常没有完整 Linux 发行版（比如只跑 MicroPython、Zephyr RTOS 或裸机 firmware），which python3 返回空是常态，不是配置错误。
- ESP32-C3（带 OpenWrt 小系统）：可能有
/usr/bin/python3，但缺esptool和串口权限 - Raspberry Pi Pico（仅 UF2 模式）：根本没有 SSH 服务，所谓“SSH”其实是通过 USB CDC + 自定义 bridge daemon 模拟的，Remote-SSH 无法直连
- nRF52840（Zephyr + west）：需提前在板子上跑
west flash --runner pyocd的配套服务，否则make flash会卡在pyocd list
如何让 Remote-SSH 真正支持烧录与运行
核心思路：把烧录动作封装成远程可执行的脚本，并用 VS Code 的 tasks.json 调用它，而不是依赖 Python 扩展自动 run。
- 在开发板侧（或其网关机）部署一个轻量级 agent，监听 HTTP/Unix socket，接收固件二进制并调用
esptool write_flash或adafruit-nrfutil dfu serial - 在 VS Code 工作区根目录建
.vscode/tasks.json，定义 task："command": "ssh user@board-ip '/opt/flash.sh ${fileBasenameNoExtension}.bin'" - 确保
~/.ssh/config中该 Host 启用ForwardAgent yes，否则 agent 无法复用本地密钥访问 GitHub 私仓获取 SDK - 若用 PlatformIO，禁用其内置串口监控（会抢
/dev/ttyACM0），改用 VS Code 终端手动screen /dev/ttyACM0 115200
文件同步慢、改完不生效的底层原因
Remote-SSH 默认使用 rsync 增量同步，但低功耗板常挂载为只读 FAT32（如 Pico 的 UF2 分区）、或通过 FUSE 挂载（如 ESP-IDF 的 idf.py monitor 虚拟串口），rsync 无法 stat 文件时间戳，会退化成全量拷贝 + 超时重试。
- 解决办法：关闭自动同步，在
settings.json加"remote.SSH.fileWatcher.polling": true，强制轮询而非 inotify - 更可靠做法：用
scp替代 rsync，写成 preLaunchTask："command": "scp ${file} user@board-ip:/tmp/src/" - 注意路径权限：
/tmp在多数嵌入式 Linux 中是 tmpfs，重启即丢；若要持久化，必须写到/mnt/sdcard并提前mount -o rw,remount /mnt/sdcard
调试器根本起不来？先查三件事
Remote-SSH + Cortex-Debug 插件组合在低功耗场景下极易失败，90% 问题出在 GDB server 侧，而非 VS Code 配置。
- 确认开发板是否真正运行了
openocd -f interface/cmsis-dap.cfg -f target/nrf52.cfg -c "gdb_port 3333"，很多厂商 demo 脚本只跑一次就退出 - 检查
launch.json中"miDebuggerPath"指向的是远程的arm-none-eabi-gdb，不是本地的；且版本必须匹配芯片（nRF52 要 8.3+，ESP32-S3 要 11.2+） - Windows 用户特别注意：WSL2 下启动的 OpenOCD 无法访问 Windows 主机上的 CMSIS-DAP 设备，必须在 Windows 原生终端里启动 GDB server
真正的难点不在连接，而在让烧录、日志、调试三个通道互不干扰——它们共享同一物理串口或 USB 接口，顺序错了就会锁死设备。别指望一键 launch 全搞定，每个环节都要单独验证通路。
