Ubuntu下VSCode配置C++开发环境：从GCC到CMake的完整指南

1. 项目概述：为什么要在Ubuntu上配置C++环境？

如果你是一名C++开发者，或者正在学习系统编程、高性能计算，那么Ubuntu大概率是你的首选操作系统之一。它开源、免费，拥有庞大的社区和几乎无限的自由度，是搭建开发环境的绝佳平台。但很多朋友，尤其是刚从Windows或macOS转过来的新手，面对一个“干净”的Ubuntu桌面时，往往会感到一丝迷茫：我知道要装GCC、CMake，也知道VSCode好用，但具体怎么把它们串起来，形成一个高效、稳定、可调试的“开箱即用”环境呢？

这就是我们今天要彻底解决的问题。我将分享两种在Ubuntu系统上，使用VSCode配置C++开发环境的完整方案。这两种方案并非简单的“安装-运行”，而是基于不同的项目需求和开发习惯设计的。第一种是基于GCC/G++和GDB的经典命令行驱动方案，它轻量、直接，适合学习语言本身、编写小型工具或脚本。第二种是基于CMake构建系统的现代项目方案，它结构化、可扩展，是管理中型到大型C++项目的行业标准。无论你是想快速验证一个算法，还是准备启动一个严肃的软件项目，都能在这里找到对应的路径。

整个配置过程，我会带你从零开始，不仅告诉你“点哪里”，更会解释“为什么这么做”。你会了解到每个工具（GCC, CMake, VSCode插件）在工具链中的角色，如何配置关键文件（如tasks.json,launch.json,CMakeLists.txt），以及如何避开那些我当年踩过的坑。最终，你将获得一个支持智能提示、代码跳转、一键编译运行、断点调试的完整IDE体验，而且完全理解其背后的运作机制。

2. 环境整体设计与思路拆解

在动手之前，我们先理清思路。一个完整的C++开发环境，核心是工具链和集成环境。

工具链负责将源代码变成可执行程序，主要包括：

1. 编译器：如GCC中的g++，负责将.cpp文件编译成机器码。
2. 链接器：通常是编译器套件的一部分（如GCC的ld），负责将多个编译后的目标文件（.o）和库文件链接成最终的可执行文件或库。
3. 构建系统：如Make或CMake。当项目有多个文件时，手动输入编译命令非常低效。构建系统能根据依赖关系，自动化执行编译和链接步骤。CMake又是一个“构建系统的构建系统”，它生成标准的Makefile，从而兼容不同的平台和编译器。
4. 调试器：如GDB，用于在程序运行时检查状态、设置断点、查看变量，是排查复杂Bug的利器。

集成环境（VSCode）则为我们提供了一个统一的图形化界面来调用这些工具链，并通过插件增强功能，如：

• 代码智能感知：自动补全、函数签名提示、错误检查。
• 项目管理：文件浏览、多文件夹工作区。
• 集成终端：直接在编辑器内调用系统命令行。
• 图形化调试：将GDB的命令行调试功能转化为可视化的断点、变量监视面板。

因此，我们的配置工作，本质上就是在Ubuntu上安装并配置好这套工具链，然后教会VSCode如何与它们交互。

两种配置方式的根本区别在于构建系统的选择：

• 方式一（GCC/G++直接编译）：适用于文件数量少、结构简单的项目。我们通过VSCode的“任务（Tasks）”功能，直接调用g++命令来编译和运行。这种方式直观，依赖少，适合快速原型验证。
• 方式二（CMake构建）：适用于任何规模，尤其是多目录、多模块、依赖第三方库的项目。我们使用CMake来定义项目结构、编译选项和依赖关系，VSCode的CMake插件会读取CMakeLists.txt文件，并提供一个图形化界面来配置、构建和调试。这是管理复杂项目的标准做法。

接下来，我们将进入实战环节。请确保你有一个可用的Ubuntu系统（我使用的是22.04 LTS，但步骤适用于大多数现代版本）。

3. 基础环境准备：安装核心工具链

无论选择哪种方式，一些基础工具是必须的。打开你的终端（Ctrl+Alt+T），让我们开始。

3.1 更新系统包列表

这是一个好习惯，能确保我们安装的是软件源中最新的版本。

sudo apt update

3.2 安装编译器和调试器

我们将安装GNU编译器集合（GCC）和调试器（GDB）。

sudo apt install build-essential gdb

• build-essential：这是一个元数据包，它会自动安装gcc,g++,make,libc6-dev等一整套编译和构建所必需的工具。这是最省事的方法。
• gdb：GNU调试器。

安装完成后，验证一下：

g++ --version gdb --version

如果能看到版本号信息，说明安装成功。

3.3 安装CMake（为方式二准备）

对于方式二，我们需要CMake。Ubuntu仓库中的CMake版本可能较旧，对于需要最新特性的项目，建议从Kitware官方APT仓库安装。

# 首先卸载旧版本（如果有） sudo apt remove --purge cmake # 安装依赖 sudo apt install software-properties-common lsb-release apt-transport-https ca-certificates gnupg # 添加Kitware官方APT仓库 wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc 2>/dev/null | gpg --dearmor - | sudo tee /etc/apt/trusted.gpg.d/kitware.gpg >/dev/null sudo apt-add-repository "deb https://apt.kitware.com/ubuntu/ $(lsb_release -cs) main" # 更新并安装CMake sudo apt update sudo apt install cmake cmake-curses-gui

安装cmake-curses-gui（即ccmake）是一个可选但有用的步骤，它提供了一个终端图形界面来配置CMake项目。

验证安装：

cmake --version

3.4 安装VSCode

你可以从Snap商店或直接下载.deb包安装。这里使用官方APT仓库的方式，便于更新。

# 导入微软GPG密钥 wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg sudo install -o root -g root -m 644 packages.microsoft.gpg /etc/apt/trusted.gpg.d/ sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/trusted.gpg.d/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list' # 安装VSCode sudo apt update sudo apt install code

安装后，可以在应用菜单中找到Visual Studio Code。

4. 方式一详解：基于GCC/G++的直接编译与调试

这种方式的核心思想是：我们手动编写编译命令，然后利用VSCode的“任务（Task）”功能来一键执行它，并用“启动（Launch）”配置来连接调试器。

4.1 创建示例项目并安装VSCode插件

首先，创建一个项目目录并打开VSCode。

mkdir cpp_simple_project && cd cpp_simple_project code .

在VSCode中，我们需要安装一个核心插件：C/C++，由Microsoft发布。这个插件提供了代码智能感知、浏览、调试等功能。

1. 点击左侧活动栏的“扩展”图标（或按Ctrl+Shift+X）。
2. 搜索“C/C++”。
3. 找到“C/C++”插件（作者是Microsoft），点击“安装”。

4.2 编写示例代码

在VSCode的资源管理器中，新建一个文件main.cpp，输入以下简单的测试代码：

#include <iostream> #include <vector> int main() { std::vector<int> numbers = {1, 2, 3, 4, 5}; int sum = 0; std::cout << "Calculating the sum of vector elements..." << std::endl; for (int num : numbers) { sum += num; } std::cout << "The sum is: " << sum << std::endl; return 0; }

4.3 配置编译任务（tasks.json）

我们需要告诉VSCode如何编译这个文件。VSCode通过tasks.json文件来定义任务。

1. 按Ctrl+Shift+P打开命令面板。
2. 输入“Tasks: Configure Task”，然后选择“Create tasks.json file from template”。
3. 在出现的模板列表中，选择“Others”来创建一个空的任务模板。

这会在项目根目录下创建一个.vscode文件夹，里面有一个tasks.json文件。用以下内容替换它：

{ "version": "2.0.0", "tasks": [ { "label": "build with g++", "type": "shell", "command": "g++", "args": [ "-g", // 生成调试信息，这是调试的关键 "-std=c++11", // 使用C++11标准，可根据需要改为c++14, c++17等 "${file}", // 编译当前活动文件 "-o", // 指定输出文件名 "${fileDirname}/${fileBasenameNoExtension}.out" // 输出到同目录，去掉.cpp后缀，加上.out ], "group": { "kind": "build", "isDefault": true // 设为默认生成任务 }, "presentation": { "echo": true, "reveal": "always", // 总是在终端显示输出 "focus": false, "panel": "shared" // 使用共享的输出面板 }, "problemMatcher": { "owner": "cpp", "fileLocation": ["relative", "${workspaceFolder}"], "pattern": { "regexp": "^(.*):(\\d+):(\\d+):\\s+(warning|error):\\s+(.*)$", "file": 1, "line": 2, "column": 3, "severity": 4, "message": 5 } } } ] }

关键参数解析：

• label: 任务名称，会在命令面板中显示。
• type:shell表示在终端中执行命令。
• command: 要执行的命令，这里是g++。
• args: 传递给g++的参数列表。
  • -g:至关重要。它告诉编译器在可执行文件中包含调试符号（如变量名、行号信息），没有这个标志，GDB将无法进行源代码级别的调试。
  • -std=c++11: 指定使用的C++语言标准。
  • ${file}: VSCode的预定义变量，代表当前在编辑器中活动的文件（我们的main.cpp）。
  • -o: 指定输出文件。
  • ${fileDirname}/${fileBasenameNoExtension}.out: 输出路径。${fileDirname}是当前文件所在目录，${fileBasenameNoExtension}是当前文件名（不含扩展名）。我们输出一个.out文件。
• group: 将任务归类到“生成”组，并设为默认。这样你可以按Ctrl+Shift+B直接运行这个任务。
• presentation: 控制任务运行时终端的显示行为。
• problemMatcher: 用于解析编译器输出的错误和警告信息，并将其显示在VSCode的“问题”面板中。这个正则表达式模式能匹配GCC/G++的典型错误输出格式。

实操心得：-g标志是调试的“入场券”，务必确保它在你的编译参数里。另外，problemMatcher能极大提升效率，编译器错误会直接变成可点击的链接，点击就能跳转到出错行。

4.4 配置调试任务（launch.json）

编译成功后，我们需要配置如何启动调试。VSCode通过launch.json文件来配置调试。

1. 切换到VSCode的“运行和调试”视图（左侧活动栏的三角+虫子图标，或按Ctrl+Shift+D）。
2. 点击“创建一个launch.json文件”。
3. 在弹出的环境选择中，选择“C++ (GDB/LLDB)”。

这会在.vscode文件夹下创建launch.json文件。用以下内容替换：

{ "version": "0.2.0", "configurations": [ { "name": "(gdb) Launch", "type": "cppdbg", "request": "launch", "program": "${fileDirname}/${fileBasenameNoExtension}.out", "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 with g++", // 调试前先执行编译任务 "miDebuggerPath": "/usr/bin/gdb" } ] }

关键参数解析：

• name: 调试配置的名称，显示在调试下拉列表中。
• type: 调试器类型，cppdbg是微软C++扩展提供的。
• request:launch表示启动一个新的程序进行调试。
• program: 要调试的程序路径，这里指向我们编译生成的.out文件。
• preLaunchTask:这是实现“一键调试”的关键。它指定在启动调试器之前，先运行tasks.json中哪个label的任务。这里我们填入之前定义的"build with g++"。这样，当你按F5开始调试时，VSCode会自动先编译代码（如果源代码有改动），再启动调试。
• miDebuggerPath: GDB的路径，通常是/usr/bin/gdb。

4.5 运行与调试

现在，一切就绪。

编译并运行：

• 确保main.cpp是当前活动文件。
• 按Ctrl+Shift+B（运行默认生成任务）。你会在集成终端看到编译命令执行，如果没有错误，会生成main.out文件。
• 在终端中，输入./main.out即可运行程序。

一键调试：

• 在代码中（比如for循环那一行）点击左侧边栏设置一个断点（红色圆点）。
• 直接按F5。VSCode会依次执行：
  1. 调用preLaunchTask，即“build with g++”任务，编译代码。
  2. 启动GDB调试器，程序会在断点处暂停。
• 此时，你可以使用顶部的调试控制栏（继续、单步跳过、单步进入、重启、停止），也可以在左侧的“变量”窗口查看当前作用域内的变量值，在“监视”窗口添加自定义表达式。

注意事项：这种方式对于单个或少数几个文件非常有效。但当项目文件增多，需要链接库时，tasks.json中的编译命令会变得非常冗长和难以维护。这时，就该方式二登场了。

5. 方式二详解：基于CMake的现代化项目管理

CMake通过一个声明式的CMakeLists.txt文件来描述项目的构建过程，它能自动生成对应平台（Unix的Makefile， Windows的Visual Studio项目等）的构建文件。VSCode有强大的CMake插件支持。

5.1 安装VSCode的CMake插件

在扩展商店中搜索并安装以下两个插件：

1. CMake(作者：twxs)：提供CMake语言支持。
2. CMake Tools(作者：Microsoft)：这是核心插件，提供了配置、构建、测试、调试CMake项目的全套图形化工具。

5.2 创建CMake项目结构

让我们创建一个更结构化的项目。关闭之前的简单项目，新建一个目录并打开。

mkdir cmake_project && cd cmake_project code .

项目结构规划如下：

cmake_project/ ├── CMakeLists.txt # 项目根CMake配置文件 ├── include/ # 头文件目录 │ └── calculator.h ├── src/ # 源文件目录 │ ├── calculator.cpp │ └── main.cpp └── build/ # 构建输出目录（通常.gitignore）

1. 创建include/calculator.h：

#ifndef CALCULATOR_H #define CALCULATOR_H class Calculator { public: int add(int a, int b); int multiply(int a, int b); }; #endif // CALCULATOR_H

2. 创建src/calculator.cpp：

#include "../include/calculator.h" int Calculator::add(int a, int b) { return a + b; } int Calculator::multiply(int a, int b) { return a * b; }

3. 创建src/main.cpp：

#include <iostream> #include "calculator.h" int main() { Calculator calc; std::cout << "3 + 4 = " << calc.add(3, 4) << std::endl; std::cout << "3 * 4 = " << calc.multiply(3, 4) << std::endl; return 0; }

5.3 编写核心：CMakeLists.txt

在项目根目录创建CMakeLists.txt，这是CMake的“蓝图”。

# 指定CMake的最低版本要求 cmake_minimum_required(VERSION 3.10) # 定义项目名称和使用的编程语言 project(MyCmakeProject LANGUAGES CXX) # 设置C++标准 set(CMAKE_CXX_STANDARD 11) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 告诉CMake头文件在哪里，这样源代码中的`#include "calculator.h"`才能被找到 include_directories(include) # 添加可执行目标 add_executable(my_app src/main.cpp src/calculator.cpp) # 更优雅的写法：使用变量收集源文件 # set(SOURCES src/main.cpp src/calculator.cpp) # add_executable(my_app ${SOURCES})

关键指令解析：

• project(): 定义项目名称，并指定语言。这会创建一些变量如PROJECT_NAME。
• set(CMAKE_CXX_STANDARD 11): 强制使用C++11标准，避免不同编译器默认标准不同导致的问题。
• include_directories(): 添加头文件搜索路径。相当于给编译器传递-I include参数。
• add_executable(): 定义我们要构建的可执行文件my_app，并列出其依赖的所有源文件。

5.4 使用CMake Tools插件配置与构建

1. 配置(Configure)：

• 按下Ctrl+Shift+P打开命令面板。
• 输入“CMake: Configure”，选择它。或者，在底部状态栏，你会看到CMake Tools插件提供的按钮（通常显示“No Kit Selected”），点击它选择一个Kit（编译器套件）。对于GCC，选择“GCC x.x.x...”即可。
• 首次配置，插件会提示你选择一个“Kit”。选择我们安装的GCC套件。
• 配置过程会在项目根目录（或你指定的目录，如build）生成CMakeCache.txt和一系列构建文件（如Makefile）。

2. 构建(Build)：

• 命令面板输入“CMake: Build”，或点击状态栏的“Build”按钮（锤子图标）。
• 构建输出默认在build目录下。你可以在CMakeLists.txt中通过set(CMAKE_BINARY_DIR ${CMAKE_SOURCE_DIR}/build)来指定，但更常见的做法是直接在build目录下执行cmake命令（命令行方式），或者让CMake Tools插件管理。插件通常会在项目根目录下创建一个build文件夹用于输出。

3. 运行：构建成功后，可执行文件my_app位于构建目录（如./build/）下。可以在VSCode的集成终端中运行：

cd build ./my_app

CMake Tools插件也提供了“运行”按钮（播放图标），可以直接运行目标。

5.5 配置VSCode调试CMake项目

CMake Tools插件与调试器集成得非常好。

1. 首先，确保你的CMakeLists.txt在add_executable命令中包含了调试信息。我们之前设置的set(CMAKE_CXX_STANDARD 11)不会影响调试信息。CMake的默认构建类型（Build Type）通常是“Debug”或未指定。为了明确，我们可以在配置时指定。

   • 在命令面板执行“CMake: Delete Cache and Reconfigure”。
   • 在出现的快速选择列表中，选择“Debug”。这会在生成的构建系统中加入-g标志。

2. 配置launch.json。切换到“运行和调试”视图，点击“创建一个launch.json文件”，这次选择“C++ (GDB/LLDB)”。VSCode可能会自动检测到CMake项目并生成一个配置。如果没有，或者你想自定义，可以使用如下配置：

{ "version": "0.2.0", "configurations": [ { "name": "(gdb) Launch CMake Target", "type": "cppdbg", "request": "launch", "program": "${command:cmake.launchTargetPath}", "args": [], "stopAtEntry": false, "cwd": "${workspaceFolder}", "environment": [], "externalConsole": false, "MIMode": "gdb", "setupCommands": [ { "description": "Enable pretty-printing for gdb", "text": "-enable-pretty-printing", "ignoreFailures": true } ], "preLaunchTask": "CMake: build" // 调试前构建 } ] }

关键区别：program参数使用了${command:cmake.launchTargetPath}。这是一个由CMake Tools插件提供的变量，它会自动解析为当前活动CMake目标（即你在CMake Tools状态栏选择的目标，如my_app）的可执行文件路径。这比硬编码路径灵活得多。

3. 在CMake Tools状态栏，确保选择的目标是my_app。
4. 在代码中设置断点，然后按F5开始调试。插件会自动构建项目（如果必要）并启动调试会话。

5.6 CMake进阶：更优雅的项目配置

上面的CMakeLists.txt是最基础的。一个更规范、可扩展的配置通常如下：

cmake_minimum_required(VERSION 3.10) project(MyCmakeProject LANGUAGES CXX) set(CMAKE_CXX_STANDARD 11) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 将头文件目录添加给目标，比include_directories更推荐 add_library(calculator_lib src/calculator.cpp) target_include_directories(calculator_lib PUBLIC include) add_executable(my_app src/main.cpp) # 将库链接到可执行文件 target_link_libraries(my_app PRIVATE calculator_lib)

这里我们创建了一个库目标calculator_lib，然后让可执行目标my_app链接它。target_include_directories将头文件目录关联到特定目标，作用域更清晰。这种方式在项目变大、有多个库时，管理起来更加清晰。

6. 两种方式对比与选择指南

为了帮助你根据项目情况做出选择，我将两种方式的核心特点总结如下：

选择建议：

• 初学者/快速验证：从方式一开始。它能让你直观理解编译、链接、调试的基本流程。
• 课程作业/小型项目：如果文件数少于10个且结构简单，两种方式均可。方式一更快捷，方式二能让你提前熟悉工业标准。
• 中型及以上项目/团队协作/开源项目：毫不犹豫选择方式二（CMake）。它是现代C++生态的事实标准，良好的CMakeLists.txt是项目可维护性和可移植性的基石。

7. 常见问题与排查技巧实录

在实际配置过程中，你几乎一定会遇到一些问题。以下是我总结的常见“坑”及其解决方案。

7.1 编译类问题

问题1：fatal error: iostream: No such file or directory

• 现象：编译时提示找不到标准库头文件。
• 原因：G++编译器没有正确安装，或者build-essential包安装不完整。
• 解决：重新安装编译套件。

  sudo apt update sudo apt install --reinstall build-essential

问题2：undefined reference toxxx‘`

• 现象：链接阶段报错，提示某个函数未定义。
• 原因（方式一下）：在tasks.json的编译命令中，忘记链接必要的源文件或库。例如，有main.cpp和utils.cpp，但编译命令只写了g++ main.cpp。
• 解决（方式一下）：确保args中包含了所有需要的.cpp文件。例如：

  "args": [ "-g", "-std=c++11", "${fileDirname}/main.cpp", "${fileDirname}/utils.cpp", // 添加其他源文件 "-o", "${fileDirname}/app.out" ]

• 原因（方式二下）：在CMakeLists.txt的add_executable或add_library命令中，漏掉了某个源文件。
• 解决（方式二下）：检查add_executable(my_app src/main.cpp src/calculator.cpp ...)是否列出了所有必需的.cpp文件。

问题3：CMake配置时找不到编译器

• 现象：执行CMake Configure时，提示“No CMAKE_CXX_COMPILER could be found”。
• 原因：CMake在指定路径下找不到G++。
• 解决：
  1. 确认G++已安装：which g++。
  2. 如果已安装，可能是CMake缓存问题。删除项目下的CMakeCache.txt文件和CMakeFiles目录（或整个build目录），然后重新配置。
  3. 在VSCode的CMake Tools设置中，手动指定Kit路径（通常不需要）。

7.2 调试类问题

问题4：按F5启动调试，程序一闪而过，没有在断点处停止

• 现象：程序似乎直接运行完毕，调试控制台没有停留。
• 原因：编译时没有包含-g调试信息，或者launch.json中的program路径指向了错误的（未包含调试信息的）可执行文件。
• 解决：
  1. 对于方式一：检查tasks.json中的args是否包含-g。
  2. 对于方式二：确保CMake的构建类型是“Debug”。可以在VSCode底部状态栏点击构建类型（可能显示“Release”），切换为“Debug”。或者，在命令行构建时使用cmake -DCMAKE_BUILD_TYPE=Debug ..。
  3. 检查launch.json中的program路径是否正确指向了最新编译出的可执行文件。

问题5：调试时变量窗口显示<optimized out>

• 现象：在调试器中查看变量值时，显示为<optimized out>。
• 原因：编译器优化（如-O2）可能会移除或重用某些变量，导致调试器无法访问。在Debug构建中，通常应禁用优化。
• 解决：
  • 方式一：在tasks.json的args中添加-O0（字母O后跟数字0）来禁用优化。

  "args": [ "-g", "-O0", // 禁用优化 "-std=c++11", ... ]

  • 方式二：CMake的Debug构建类型默认会包含-g并通常禁用优化。如果仍有问题，可以在CMakeLists.txt中显式设置：

  if(CMAKE_BUILD_TYPE STREQUAL "Debug") target_compile_options(my_app PRIVATE -O0) endif()

7.3 VSCode与插件问题

问题6：代码智能感知（IntelliSense）不工作，红色波浪线

• 现象：头文件下有红色波浪线，提示“无法打开源文件”。
• 原因：VSCode的C/C++插件不知道你的头文件路径。
• 解决：
  1. 按Ctrl+Shift+P，输入“C/C++: Edit Configurations (UI)”，打开配置UI。
  2. 在“包含路径”一栏，添加你的项目头文件路径，例如${workspaceFolder}/include，或者对于系统级路径，可以添加/usr/include等。
  3. 更推荐的方法是让插件自动配置。对于方式二（CMake），C/C++插件通常能与CMake Tools插件协作，自动获取包含路径。确保两个插件都已安装并启用。有时需要重新加载窗口（Ctrl+Shift+P-> “Developer: Reload Window”）或重新配置CMake项目。

问题7：CMake Tools插件状态栏不显示或无法选择Kit

• 现象：底部状态栏没有CMake相关的按钮，或者Kit显示为“No Kit Selected”。
• 解决：
  1. 确保已安装“CMake Tools”插件并启用。
  2. 打开一个包含CMakeLists.txt文件的文件夹。
  3. 如果仍不显示，尝试在命令面板运行“CMake: Scan for Kits”来强制扫描编译器。
  4. 检查系统是否确实安装了GCC（g++ --version）。

7.4 环境与路径问题

问题8：终端中命令找不到，但VSCode任务可以运行

• 现象：在VSCode的集成终端里输入g++提示“command not found”，但通过tasks.json运行编译任务却成功。
• 原因：VSCode的任务（Task）和集成终端（Terminal）可能使用了不同的shell环境或PATH变量。任务运行时，VSCode可能会继承或构造一个特定的环境。
• 解决：重启VSCode通常可以解决。如果问题持续，检查你的系统shell配置文件（如~/.bashrc或~/.zshrc），确保PATH设置正确。也可以在VSCode的用户设置中搜索“terminal.integrated.env.linux”，添加自定义的环境变量。

配置环境是一个典型的“一次配置，长期受益”的过程。初期遇到问题很正常，耐心按照上述步骤排查，并理解每个配置项的作用，你就能建立起一个稳固且高效的C++开发基地。两种方式都掌握后，你可以根据项目需求灵活切换，游刃有余。