必须三端版本对齐、符号完整、网络通路干净；交叉编译需加-g且禁用-o2以上优化；vscode调试依赖正确配置midebuggerpath与midebuggerserveraddress，并确保gdbserver版本不高于交叉gdb版本。

能用，但必须确保三端版本对齐、符号完整、网络通路干净——缺一不可。

交叉编译时必须加 -g 且禁用 -O2 以上优化

没有调试符号，VSCode 就算连上 gdbserver 也看不到变量、跳不进函数、断点会飘移。常见错误现象包括：Cannot find bounds of current function、optimized out、断点显示为灰色空心圆。

• -g 是底线，必须加；推荐同时加 -gdwarf-4 提高兼容性
• 避免 -O2 或 -O3：内联、寄存器分配、指令重排会让源码行与机器指令严重脱节；开发阶段用 -O0 或 -O1 更稳妥
• 若需保留部分优化又想保符号，可尝试 -O2 -g -fno-omit-frame-pointer，但仍有风险
• 验证是否含符号：file your_app 应显示 with debug_info；readelf -S your_app | grep debug 应有多个 .debug_* 段

launch.json 中 miDebuggerPath 和 miDebuggerServerAddress 必须精准指向

这里错一个路径或 IP，VSCode 启动 GDB 就直接报 Failed to launch GDB 或卡在 “Connecting to gdbserver…”。

Zynq Linux Hardware Debug

Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。

下载

• miDebuggerPath 必须是交叉 GDB 路径，不是系统 gdb：例如 /usr/bin/arm-linux-gnueabihf-gdb，不是 /usr/bin/gdb
• miDebuggerServerAddress 格式为 "192.168.1.100:1234"（字符串，带引号），不能写成 192.168.1.100:1234（无引号）或 192.168.1.100:123456（端口超范围）
• 端口号建议避开 1–1024（需 root）、22（SSH 冲突）、以及已占用端口；实测 1234、9001、2345 较稳定
• 如果开发机和板子之间隔着 NAT 或防火墙，别硬调 miDebuggerServerAddress，改用 SSH port-forward（见下一条）

当网络不可直连时，用 SSH port-forward 替代裸 TCP 连接

很多现场环境（如通过路由器中转、板子走 WiFi、公司内网策略限制）根本做不到 PC 直连开发板 IP。此时硬配 miDebuggerServerAddress 必然失败，表现为 VSCode 等待超时、gdbserver 无连接日志、netstat -tlnp | grep :1234 在板子上能看到监听，但 PC 上 telnet 192.168.1.100 1234 不通。

• 先在 PC 端建立隧道：ssh -L 1234:localhost:1234 root@192.168.1.100（假设板子 IP 是 192.168.1.100）
• 然后在板子上启动 gdbserver：gdbserver :1234 ./your_app（注意是 :1234，不是 localhost:1234）
• launch.json 中设 "miDebuggerServerAddress": "localhost:1234" —— VSCode 现在连的是本机隧道端口
• 该方式绕过所有中间网络策略，只要 SSH 能通，调试就能通；且复用已有的密钥认证和连接配置

gdbserver 版本必须 ≤ 交叉 GDB 版本

版本倒挂（比如用 gdb-12 的交叉 GDB 连 gdbserver-8）会导致协议解析失败，典型错误是：Remote 'g' packet reply is too long、Unexpected reply from gdbserver、或 VSCode 卡在初始化寄存器读取阶段。

• 查版本：arm-linux-gnueabihf-gdb --version 和 gdbserver --version（在板子上运行）
• 优先使用同一工具链发布的配套 gdb + gdbserver；Linaro 工具链通常打包完整
• 若板子上 gdbserver 太老（如 OpenWrt 默认的 7.x），又无法升级系统，可交叉编译新版 gdbserver 静态链接后推上去：./configure --target=arm-linux-gnueabihf --enable-static --prefix=/tmp/gdbserver-static && make && make install
• 别忽略 libc 兼容性：静态链接可规避 libc version mismatch 类错误

最常被忽略的其实是符号路径和工作目录一致性——program 字段指定的 ELF 文件，其 build id 必须和板子上运行的完全一致；且 VSCode 启动调试时的 cwd 最好和交叉编译时的输出路径一致，否则源码路径映射容易失效。