vscode编译调试环境安装-Go服务器开发

好的，配置 VSCode 用于 Linux 下 C/C++ 项目的编译和调试，可以分为几个核心步骤。以下是清晰、详细的指南，涵盖本地和远程两种主要开发模式。

您可以根据您的项目情况选择对应的路径。

核心概念：两种工作模式

本地开发（Local Development）：
- 适用场景：您的项目直接在本地 Linux 系统（物理机或虚拟机）上开发。
- 流程：VSCode 安装在 Linux 上，直接调用本地的工具链（gcc, gdb, cmake等）。
远程开发（Remote Development）：
- 适用场景：您的代码在远程的 Linux 服务器或高性能工作站上，但您希望在 Windows/macOS 本地使用 VSCode 进行编辑和调试。
- 流程：使用 VSCode 的 Remote-SSH 扩展连接到远程机器，所有插件和命令执行都在远程服务器上完成，为您提供无缝的体验。

第一步：安装必备工具链（在您的 Linux 环境中）

无论哪种模式，Linux 环境本身必须具备编译和调试工具。

打开终端，执行以下命令（以 Ubuntu/Debian 为例）：

# 更新软件包列表
sudo apt update

# 安装编译套件 (g++, gcc, make)
sudo apt install build-essential

# 安装调试器 (GDB)
sudo apt install gdb

# （可选但推荐）安装 CMake 及其工具
sudo apt install cmake cmake-curses-gui

# （可选）安装自动化构建工具 (如 ninja)
sudo apt install ninja-build

第二步：安装 VSCode 及必要扩展

安装 VSCode：
- 从 VSCode 官网下载并安装。
安装核心扩展：打开 VSCode，进入 Extensions 市场 (Ctrl+Shift+X)，搜索并安装以下扩展：
- C/C++ (由 Microsoft 发布)：提供 C/C++ 语言的 IntelliSense、调试等功能。
- CMake Tools (由 Microsoft 发布)：如果您使用 CMake，这是必备神器。
- (仅限远程开发) Remote - SSH (由 Microsoft 发布)：用于连接到远程 Linux 服务器。

【模式一】本地开发配置流程

Part A: 配置编译器与生成任务 (`tasks.json`)

tasks.json 文件用于定义如何编译项目（例如调用 g++或 make）。

打开您的项目文件夹。
按 Ctrl+Shift+P，输入 Configure Tasks，选择 “Tasks: Configure Task” -> “Create tasks.json file from template” -> “Others”。
这会在项目下的 .vscode 文件夹中生成一个 tasks.json文件。将其修改为类似以下内容：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Build My Project", // 任务名称，可自定义
            "type": "shell",
            "command": "g++",           // 编译器命令
            "args": [
                "-g",                   // -g:生成调试信息
                "${file}",              // ${file}:当前打开的文件
                "-o", 
                "${fileDirname}/${fileBasenameNoExtension}.out" //输出文件
                // 可以添加更多编译选项，如 -std=c++17, -Iinclude, -Llib, -lxxx
            ],
            "group": {
                "kind": "build",
                "isDefault": true       // Ctrl+Shift+B 快捷键默认执行此任务
            },
            "presentation": {
                "echo": true,
                "reveal": "always",     //总显示输出窗口
                "focus": false,
                "panel": "shared"
            },
            "problemMatcher": ["$gcc"]
        }
    ]
}

现在，按 Ctrl+Shift+B 即可编译当前文件。

*如果使用 Makefile*，任务更简单：

{
    ...
            “label”: “Build with Make“,
            “type”: “shell“,
            “command”: “make“,          //直接调用make
            “args”: [],
    ...
}

Part B:配置调试器 (`launch.json`)

launch.json文件用于告诉VSCode如何启动调试器。

按 Ctrl+Shift+P，输入 Configure Debugging，选择 “Debug: Open launch.json” -> “C++ (GDB/LLDB)”。
选择 “(gdb) Launch”。这会生成一个模板化的 launch.json文件。
修改关键配置项：

{
    “version”: “0.2.0“,
    ”configurations”: [
        {
            ”name”: “(gdb) Launch“,     //配置名称
            ”type”: “cppdbg“,
            ”request”: “launch“,
            ”program”: “${fileDirname}/${fileBasenameNoExtension}.out“,//要调试的程序路径(与tasks.json中的输出一致)
             ”args”: [],                 //程序运行时参数
             ”stopAtEntry”: false,
             ”cwd”: “${workspaceFolder}”,
             ”environment”: [],
             ”externalConsole”： false，
             ”MIMode”： “gdb”，         //指定调试器为GDB
            
            
            
            
            
            
            
            
            
            
            
            
            
            
            
             //
// !!!最重要的一步：在调试前先执行编译任务!!!
//
             ”preLaunchTask”： “Build My Project”//必须与tasks.json中的”label”完全一致
            
        }
    ]
}

现在，打开一个 .cpp文件，按 F5键，VSCode会先执行 preLaunchTask指定的编译任务，然后自动启动调试器。您可以在左侧Debug视图看到变量、调用堆栈、监视窗口，并可以设置断点、单步执行。

【模式二】远程开发配置流程（推荐）

这种方法完美结合了Windows/macOS的桌面体验和Linux的强大命令行环境。

确保远程Linux服务器已开启SSH服务。
在VSCode中安装 Remote - SSH扩展。
点击左下角的绿色按钮 > Remote-SSH: Connect to Host… > Configure SSH Hosts… >选择您的SSH配置文件（例如 ~/.ssh/config) ，添加服务器连接信息：

Host MyRemoteServer      #一个易记的别名
    HostName192.168.1.100 #服务器的IP或域名    
User your_username      #登录用户名    
# IdentityFile ~/.ssh/id_rsa #(可选)指定私钥文件

保存后，再次点击左下角绿色按钮，从列表中选择 `MyRemoteServer”。VSCode会新开一个窗口连接到该服务器。
在新的远程窗口中，再次安装 C/C++**和 *CMake Tools*扩展。这些扩展将运行在远程服务器上。**
现在您可以像在本地一样打开远程服务器上的文件夹、编辑代码、配置 `tasks.json‘和’launch.json‘。所有命令（编译、调试）都在远端执行。

![[Pasted image20240521112345.png]]

(示意图：VSCode通过Remote-SSH连接到Linux服务器)

【高级】使用CMake Tools扩展（强烈推荐）

如果项目使用CMake,上述手动配置 `tasks.json‘和’launch.json‘的步骤可以大大简化。

1.在远程或本地窗口中,打开CMake项目文件夹。
2.CMake Tools扩展会自动检测并提示您配置工具包(Kit),选择正确的编译器(如GCC)。
3.按下方状态栏的”Build“按钮即可编译,按”Debug“按钮即可一键编译并开始调试。
该扩展会自动处理所有底层命令,是管理大型项目的首选方式。

![[Pasted image20240521112407.png]]

(示意图：VSCode底部的CMake Tools状态栏)

###总结

步骤	本地开发	远程开发(SSH)
1.准备Linux环境	物理机/虚拟机	一台Linux服务器
2.安装基础工具链	`aptinstallbuild-essential gdb‘	相同
3.安装VSCode扩展	C/C++, CMakeTools	C/C++, CMakeTools,**Remote-SSH‘
4.配置编译(`tasks.json‘)	手动或由CMakeTools生成	(在SSH窗口内操作)手动或由CMakeTools生成
5.配置调试(`launch.json‘)	手动或由CMakeTools生成	(在SSH窗口内操作)手动或由CMakeTools生成