Debug Go Projects on Windows and Linux Simultaneously with VS Code

Modern developers increasingly use VS Code with Remote SSH to develop on a local Windows machine while connecting to a Linux server, achieving a consistent development environment across platforms.

For Go projects that must run on both Windows and Linux, a properly crafted launch.json file enables automatic selection of OS‑specific debugging settings.

1. launch.json Configuration Example

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Launch msg_center",
      "type": "go",
      "request": "launch",
      "mode": "debug",
      "program": "${workspaceFolder}/app/msg_center/cmd/rpc/msg_center.go",
      "args": ["-f", "app/msg_center/cmd/rpc/etc/msg_center.yaml"],
      "windows": {
        "program": "${workspaceFolder}\\app\\msg_center\\cmd\\rpc\\msg_center.go",
        "args": ["-f", "app\\msg_center\\cmd\\rpc\\etc\\msg_center.yaml"],
        "cwd": "${workspaceFolder}"
      },
      "linux": {
        "program": "${workspaceFolder}/app/msg_center/cmd/rpc/msg_center.go",
        "args": ["-f", "app/msg_center/cmd/rpc/etc/msg_center.yaml"]
      }
    }
  ]
}

2. Understanding the OS‑Specific Sections

Windows configuration program: Uses backslashes (\\) as path separators for Windows. args: Passes the configuration file path (msg_center.yaml) to the Go program. cwd: Sets the current working directory to the workspace root.

Linux configuration program: Uses forward slashes (/) as path separators for Linux. args: Same arguments as Windows, ensuring the Linux environment loads the correct config file.

3. Benefits of Dual‑Platform Debugging

Seamless switching : When developing locally on Windows, VS Code applies the Windows settings; when connected to a remote Linux host, it automatically applies the Linux settings.

Debugging consistency : Identical debugging behavior across both OSes reduces environment‑related issues.

4. Conclusion

By configuring launch.json as shown, Go projects can be debugged on both Windows and Linux without manual adjustments, ensuring multi‑platform compatibility and improving development efficiency in remote‑development workflows.