如何使用Visual Studio Code附加调试交叉编译的Go二进制文件？

一、交叉编译带调试信息的二进制 #

Go交叉编译默认会剥离调试信息，必须添加参数保留，才能让调试器识别：

• 针对x86_64 Linux平台：
  GOOS=linux GOARCH=amd64 go build -gcflags="all=-N -l" -o your-app-amd64
• 针对ARM Linux平台（以arm64为例）：
  GOOS=linux GOARCH=arm64 go build -gcflags="all=-N -l" -o your-app-arm64
  注：-N禁用代码优化，-l禁用函数内联，这两个参数是调试正常工作的关键

二、配置VSCode的launch.json #

打开VSCode的「运行和调试」面板，点击「创建launch.json文件」，选择Go环境，然后替换成对应场景的配置：

场景1：调试本地运行的x86_64 Linux二进制 #

如果你的开发机本身就是Linux，直接用这个配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Debug Linux x86_64",
            "type": "go",
            "request": "launch",
            "mode": "exec",
            "program": "${workspaceFolder}/your-app-amd64",
            "env": {},
            "args": []
        }
    ]
}

场景2：远程调试ARM/Linux平台的二进制 #

如果目标是远程ARM设备，需要先在设备上启动调试服务：

1. 在目标ARM设备上安装Delve调试器：go install github.com/go-delve/delve/cmd/dlv@latest
2. 将交叉编译好的二进制传到设备，然后启动调试服务：
   dlv --listen=:2345 --headless=true --api-version=2 exec ./your-app-arm64

接着在VSCode的launch.json里配置远程连接：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Debug Remote ARM Linux",
            "type": "go",
            "request": "attach",
            "mode": "remote",
            "remotePath": "/绝对路径/到/设备上的your-app-arm64",
            "port": 2345,
            "host": "目标设备的IP地址",
            "program": "${workspaceFolder}",
            "env": {},
            "args": []
        }
    ]
}

注：remotePath要填设备上二进制文件的绝对路径，host替换成目标设备的实际IP

三、启动调试 #

• 本地x86_64场景：在「运行和调试」面板选中对应配置，点击启动按钮，就能设置断点调试。
• 远程ARM场景：先确认设备上的dlv服务已启动，再在VSCode选中远程调试配置，点击启动即可连接设备，断点调试。

关键注意事项 #

• 开发机和目标设备的Go版本尽量保持一致，避免调试符号不兼容。
• 远程调试时，确保目标设备的2345端口对外开放；如果设备在私有网络，可通过SSH端口转发：ssh -L 2345:localhost:2345 用户名@目标设备IP，之后VSCode连接本地2345端口即可。
• 交叉编译时必须加-gcflags="all=-N -l"，否则断点会失效。

内容的提问来源于stack exchange，提问作者Mukul Mehra