如何通过VSCode远程编译调试Eclipse开发的Linux大型C++项目以适配Raspbian系统

Hey there! I've been through a similar setup moving large C++ projects from Eclipse to VSCode for remote compiling/debugging on Raspbian, so let's walk through this step by step:

First, you'll need to connect VSCode directly to your Pi to access the project and run tools remotely:

• Install the Remote-SSH extension in VSCode: Open the Extensions panel (Ctrl+Shift+X), search for "Remote-SSH", and install the official Microsoft extension.
• Configure your Pi connection: Press F1, type Remote-SSH: Connect to Host, then select Add New SSH Host. Enter ssh pi@[your-pi-ip-address] (replace [your-pi-ip-address] with your Pi's local IP like 192.168.1.100).
• Save the SSH config when prompted (use the default ~/.ssh/config file). You can edit it later to add a friendly name:

  Host raspberrypi
      HostName 192.168.1.100
      User pi
  

• Connect to the Pi: Select your new host from the list, enter your Pi's password when prompted, and wait for VSCode to set up the remote environment.

Once connected, open a remote terminal (Ctrl+`) and install the essential C++ build tools:

sudo apt update && sudo apt install build-essential gdb cmake

• build-essential gives you gcc, g++, and make
• gdb is the debugger we'll use
• cmake is optional but highly recommended for large projects (Eclipse often uses it under the hood)

Now load your project and set up automatic compilation:

1. Open your project folder on the Pi: Go to File > Open Folder and select the path where you copied your source code (you can use scp to transfer files, or clone a git repo directly on the Pi via terminal).
2. Create a build task: Press Ctrl+Shift+B, select Create tasks.json file from template, then choose Others. Replace the default content with a task matching your project's build system:
   • For a make-based project:

     {
         "version": "2.0.0",
         "tasks": [
             {
                 "label": "build-project",
                 "type": "shell",
                 "command": "make",
                 "args": [],
                 "group": {
                     "kind": "build",
                     "isDefault": true
                 },
                 "problemMatcher": "$gcc"
             }
         ]
     }
     

   • For a cmake project (add this first to generate Makefiles):

     {
         "version": "2.0.0",
         "tasks": [
             {
                 "label": "cmake-config",
                 "type": "shell",
                 "command": "cmake -DCMAKE_BUILD_TYPE=Debug .",
                 "args": [],
                 "group": "build"
             },
             {
                 "label": "build-project",
                 "type": "shell",
                 "command": "make",
                 "args": [],
                 "group": {
                     "kind": "build",
                     "isDefault": true
                 },
                 "dependsOn": "cmake-config",
                 "problemMatcher": "$gcc"
             }
         ]
     }
     

3. Test the build: Press Ctrl+Shift+B again—VSCode will run the task and show compilation output in the terminal.

Set up one-click debugging with automatic pre-build:

1. Press F5, select C++ (GDB/LLDB) from the prompt. VSCode will generate a launch.json file in the .vscode folder.
2. Modify the file to match your project:

   {
       "version": "0.2.0",
       "configurations": [
           {
               "name": "Debug Raspbian Project",
               "type": "cppdbg",
               "request": "launch",
               "program": "${workspaceFolder}/path/to/your/executable", // Replace with your binary path
               "args": [],
               "stopAtEntry": false,
               "cwd": "${workspaceFolder}",
               "environment": [],
               "externalConsole": false,
               "MIMode": "gdb",
               "setupCommands": [
                   {
                       "description": "Enable pretty-printing for gdb",
                       "text": "-enable-pretty-printing",
                       "ignoreFailures": true
                   }
               ],
               "preLaunchTask": "build-project", // Auto-build before debugging
               "miDebuggerPath": "/usr/bin/gdb"
           }
       ]
   }
   

3. Start debugging: Press F5—VSCode will build the project first, then launch the debugger with breakpoints, variable inspection, and all standard debug tools.

• Compilation errors: Double-check that all project dependencies are installed on the Pi (use sudo apt install lib[library-name]-dev for missing libraries).
• Debugger not hitting breakpoints: Ensure your build includes debug symbols—add -g to your CFLAGS in Makefile, or set CMAKE_BUILD_TYPE=Debug in cmake.
• SSH connection issues: Verify SSH is enabled on the Pi (sudo systemctl enable ssh && sudo systemctl start ssh) and your local machine can ping the Pi.

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