必须三端版本对齐、符号完整、网络通路干净；交叉编译需加-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‑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 最好和交叉编译时的输出路径一致，否则源码路径映射容易失效。
