三亩地 三亩地SAN MU DI · CODE DIARY
交流投稿
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天，欢迎挑你感兴趣的翻一翻。

首页/学习日记/日记详情

Ubuntu 22.04/24.04 C/C++开发环境搭建：从GCC到VS Code全流程指南

发布时间：2026/8/8 7:37:20 三亩地 编程学习日记
Ubuntu 22.04/24.04 C/C++开发环境搭建：从GCC到VS Code全流程指南

1. 项目概述：为什么要在Ubuntu上搭建C/C++环境？

如果你刚从Windows或macOS转向Linux，或者正准备投身嵌入式、机器人（比如PX4）、高性能计算等领域，第一个拦路虎往往就是开发环境的搭建。网上教程很多，但要么过于零散，要么版本过时，照着做总差那么几步。今天，我就以最新的Ubuntu 22.04 LTS或24.04 LTS为例，带你从头到尾、明明白白地搭建一个完整、高效、可复现的C/C++开发环境。这不仅仅是安装几个软件，更是理解Linux下开发生态的第一步。

为什么选择Ubuntu？因为它拥有最庞大的社区和最丰富的软件源，遇到问题几乎都能找到解决方案。而C/C++作为系统级、性能至上的语言，在Linux上有着天然的亲和力，无论是驱动开发、算法实现（比如你搜的“c语言；c++；算法；”），还是像STM32、RV1106这类嵌入式交叉编译，Linux都是主力平台。我们将使用最主流、最稳定的工具链，包括GCC编译器、GDB调试器、CMake构建工具，并集成强大的VS Code编辑器，最终形成一个能应对日常开发、项目构建和问题调试的“标准作战平台”。

2. 核心工具链选型与安装前准备

在动手之前，我们先理清需要哪些核心组件。一个现代的C/C++开发环境，远不止一个编译器那么简单。

2.1 核心组件解析：编译器、构建工具与调试器

  1. GCC (GNU Compiler Collection)：这是Linux世界C/C++编译器的绝对标准。它包含了gcc（C编译器）、g++（C++编译器）以及其他语言前端。我们选择它是因为其稳定性、标准兼容性以及对各类硬件架构（x86, ARM等）的广泛支持。
  2. GDB (GNU Debugger)：强大的源代码级调试器。没有调试器的开发就像蒙眼走路，GDB允许你设置断点、查看变量、分析内存，是定位复杂Bug的利器。
  3. CMake：跨平台的自动化构建系统生成器。它不直接构建项目，而是根据一个名为CMakeLists.txt的配置文件，生成你熟悉的Makefile、Ninja文件，甚至Visual Studio或Xcode项目。使用CMake是现代C/C++项目的标配，它能极大地管理多目录、多库的复杂项目。
  4. Clang/LLVM（可选但推荐）：另一个优秀的编译器前端套件。Clang通常提供更清晰、更快速的错误和警告信息。许多开发者喜欢同时安装GCC和Clang，用于对比验证。LLVM还包含像clang-format（代码格式化）、clang-tidy（静态分析）等提升代码质量的工具。
  5. 构建工具：make是执行Makefile的基础工具，ninja是一个更专注于速度的小型构建系统，常作为CMake的后端。

2.2 系统准备与最佳实践

在开始安装前，请确保你的Ubuntu系统是最新的。打开终端（快捷键Ctrl+Alt+T），执行以下命令：

sudo apt update sudo apt upgrade -y

注意：sudo apt update是刷新本地软件包索引，获取服务器上最新的软件列表。sudo apt upgrade -y则是实际升级所有可升级的软件包。-y参数表示自动确认，避免中途询问。这是一个好习惯，能确保我们从干净的起点开始，避免因旧版本导致的依赖冲突。

如果你的系统是新安装的，可能还需要安装一些基础工具，如curl,wget,git等，它们在后期的源码下载或工具安装中会用到：

sudo apt install -y curl wget git build-essential

其中build-essential是一个元软件包，它会自动安装gcc,g++,make等编译所需的核心工具。但为了更清晰地控制版本和组件，我们接下来会进行更精细化的安装。

3. 分步安装与配置核心开发工具

我们将采用“基础编译环境 -> 高级工具 -> 编辑器集成”的路径，确保每一步都稳固。

3.1 安装GCC、G++与GDB

虽然build-essential包含了它们，但我们显式安装以便管理：

sudo apt install -y gcc g++ gdb

安装完成后，验证版本：

gcc --version g++ --version gdb --version

你应该能看到类似gcc (Ubuntu 11.4.0)这样的输出。Ubuntu 22.04 LTS默认是GCC 11，24.04 LTS可能是GCC 13或14。对于大多数开发，系统默认版本已足够。如果你需要特定版本（例如为了兼容性），可以使用sudo apt install gcc-11 g++-11来安装，并通过update-alternatives命令管理多版本。

3.2 安装CMake与Ninja

Ubuntu仓库中的CMake版本可能较旧。对于较新的项目，我们通常需要更高版本。推荐通过Kitware官方APT仓库安装最新稳定版。

首先，卸载旧版本（如果有）并安装依赖：

sudo apt remove --purge -y cmake sudo apt install -y software-properties-common lsb-release ca-certificates

然后，添加Kitware的官方仓库并安装：

wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc 2>/dev/null | sudo apt-key add - sudo apt-add-repository "deb https://apt.kitware.com/ubuntu/ $(lsb_release -cs) main" sudo apt update sudo apt install -y cmake cmake-curses-gui cmake-qt-gui

实操心得：cmake-curses-gui提供了ccmake这个终端图形化配置工具，在服务器或无GUI环境下非常有用。cmake-qt-gui则是图形化的CMake配置工具。即使你主要用命令行，也建议安装，以备不时之需。

验证安装：

cmake --version

接下来安装Ninja：

sudo apt install -y ninja-build

3.3 安装Clang/LLVM工具链

Clang工具链能提供更好的诊断信息。同样，我们安装较新的版本（以LLVM 16为例，你可以根据需要选择其他版本）：

wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key | sudo apt-key add - sudo add-apt-repository "deb http://apt.llvm.org/$(lsb_release -cs)/ llvm-toolchain-$(lsb_release -cs)-16 main" sudo apt update sudo apt install -y clang-16 clangd-16 clang-format-16 clang-tidy-16 lldb-16 llvm-16-dev lld-16

安装后，你可以创建符号链接或使用update-alternatives来设置默认版本。一个简单的方法是直接调用带版本号的命令，如clang-16。

3.4 安装常用开发库

C/C++开发离不开各种库。根据你的领域，可能需要安装不同的开发包。这里列出一些通用和常见的：

# 基础开发库（头文件和链接库） sudo apt install -y libc6-dev libstdc++-12-dev # 常用工具库 sudo apt install -y pkg-config # 帮助查找库文件 sudo apt install -y libssl-dev # OpenSSL加密库 sudo apt install -y zlib1g-dev libbz2-dev liblzma-dev # 压缩库 sudo apt install -y libncurses5-dev libreadline-dev # 终端交互库 # 图形与多媒体（如果需要） sudo apt install -y libgl1-mesa-dev libglu1-mesa-dev # OpenGL sudo apt install -y libsdl2-dev libsdl2-image-dev libsdl2-ttf-dev # SDL2 # 网络与并发 sudo apt install -y libboost-all-dev # Boost库（谨慎，体积大） sudo apt install -y libcurl4-openssl-dev # libcurl

注意事项：libboost-all-dev会安装完整的Boost库，体积非常大（几个GB）。如果你只需要其中部分组件，请使用如libboost-system-dev、libboost-filesystem-dev这样的具体包名。使用apt search libboost-来查找。

4. 集成开发环境（IDE）配置：VS Code深度定制

命令行工具是基础，但一个强大的IDE能极大提升效率。VS Code以其轻量、插件化和强大的C/C++支持成为首选。

4.1 安装VS Code

从微软官方仓库安装是最佳方式，可以自动接收更新：

wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg sudo install -D -o root -g root -m 644 packages.microsoft.gpg /etc/apt/keyrings/packages.microsoft.gpg sudo sh -c 'echo "deb [arch=amd64,arm64,armhf signed-by=/etc/apt/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/code stable main" > /etc/apt/sources.list.d/vscode.list' rm -f packages.microsoft.gpg sudo apt update sudo apt install -y code

安装后，可以在应用菜单中找到VS Code，或者直接在终端输入code启动。

4.2 配置C/C++核心插件与智能感知

启动VS Code，进入扩展市场（Ctrl+Shift+X），搜索并安装以下核心插件：

  1. C/C++ (ms-vscode.cpptools)：微软官方插件，提供IntelliSense（代码补全、提示）、调试、浏览等功能。这是核心中的核心。
  2. CMake Tools (ms-vscode.cmake-tools)：如果你使用CMake，这个插件必不可少。它能帮你配置、构建、测试和调试CMake项目。
  3. Code Runner (formulahendry.code-runner)：一键运行多种语言的代码片段，非常方便快速测试。

安装完C/C++插件后，我们需要配置IntelliSense引擎，以提供准确的代码补全和错误检查。VS Code的IntelliSense依赖于一个名为“编译数据库”的东西，它记录了编译每个文件时使用的确切编译器和参数。对于CMake项目，CMake Tools插件会自动生成它。对于非CMake项目，我们需要手动配置。

在项目根目录下创建一个.vscode文件夹，并在其中创建两个文件：c_cpp_properties.json和tasks.json。

1. 配置c_cpp_properties.json： 这个文件告诉C/C++插件如何解析你的代码。按Ctrl+Shift+P，输入“C/C++: Edit Configurations (UI)”，通过UI界面配置更直观。主要设置：

  • 编译器路径：比如/usr/bin/gcc或/usr/bin/clang-16。
  • IntelliSense 模式：选择linux-gcc-x64（如果用GCC）或linux-clang-x64（如果用Clang）。
  • 包含路径：添加你的项目头文件路径，以及系统库路径如/usr/include，/usr/local/include。对于标准库，插件通常能自动检测。

一个手动编写的示例c_cpp_properties.json可能如下：

{ "configurations": [ { "name": "Linux", "includePath": [ "${workspaceFolder}/**", "/usr/include", "/usr/local/include" ], "defines": [], "compilerPath": "/usr/bin/gcc", "cStandard": "c17", "cppStandard": "c++17", "intelliSenseMode": "linux-gcc-x64", "configurationProvider": "ms-vscode.cmake-tools" } ], "version": 4 }

注意"configurationProvider": "ms-vscode.cmake-tools"这一行，它告诉C/C++插件从CMake Tools插件获取配置信息，这对于CMake项目是首选方式。

2. 配置tasks.json(用于构建)： 这个文件定义构建任务。按Ctrl+Shift+P，输入“Tasks: Configure Task”，然后选择“Create tasks.json file from template”，再选择“Others”。这会创建一个模板。我们修改它来运行make或直接调用编译器。

一个简单的使用g++编译单个文件的任务配置：

{ "version": "2.0.0", "tasks": [ { "label": "build with g++", "type": "shell", "command": "g++", "args": [ "-g", "-std=c++17", "-Wall", "-Wextra", "-o", "${fileDirname}/${fileBasenameNoExtension}", "${file}" ], "group": { "kind": "build", "isDefault": true }, "problemMatcher": ["$gcc"] } ] }

这样，按Ctrl+Shift+B就可以编译当前打开的C++文件了。

4.3 配置CMake项目工作流

对于CMake项目，CMake Tools插件让一切变得简单。

  1. 打开一个包含CMakeLists.txt的文件夹。
  2. 底部状态栏会出现一系列CMake工具按钮（通常显示“No Kit Selected”）。
  3. 点击“No Kit Selected”或按Ctrl+Shift+P输入“CMake: Select a Kit”，选择你的编译器套件（如“GCC 11.4.0 x86_64-linux-gnu”或“Clang 16.0.0”）。
  4. 接着，点击状态栏的“Build”按钮（或输入“CMake: Build”）即可构建项目。
  5. 插件会自动生成build目录，并在其中生成编译数据库，C/C++插件据此提供完美的IntelliSense。

踩坑记录：有时IntelliSense会报错，找不到头文件，即使CMake配置正确。这通常是因为编译数据库没有及时更新。尝试以下步骤：

  1. 执行“CMake: Delete Cache and Reconfigure”。
  2. 重启VS Code。
  3. 检查.vscode/c_cpp_properties.json中是否引用了ms-vscode.cmake-tools作为配置提供者。

4.4 配置调试环境

VS Code的调试功能非常强大。对于使用GCC编译并带有-g调试符号的程序，配置调试很简单。

在.vscode文件夹下创建launch.json文件。按Ctrl+Shift+P，输入“Debug: Add configuration”，选择“C++ (GDB/LLDB)”。一个基础的配置如下：

{ "version": "0.2.0", "configurations": [ { "name": "(gdb) Launch", "type": "cppdbg", "request": "launch", "program": "${workspaceFolder}/build/你的可执行文件名", // 修改为你的程序路径 "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++" // 这里对应tasks.json中的label，实现启动前自动构建 } ] }

配置好后，按F5即可启动调试，左侧会出现变量查看、调用堆栈等面板，可以设置断点、单步执行，体验不输于大型IDE。

5. 实战：从零创建一个CMake项目并调试

理论说再多不如动手一试。我们来创建一个经典的“Hello World”项目，并体验完整的编辑、构建、调试流程。

5.1 创建项目结构

打开终端，创建项目目录并进入：

mkdir my_cmake_project && cd my_cmake_project

创建源代码文件src/main.cpp：

mkdir src cat > src/main.cpp << 'EOF' #include <iostream> #include <vector> #include <string> int main() { std::vector<std::string> msg {"Hello", "C++", "World", "from", "VS Code", "and the C++ extension!"}; for (const std::string& word : msg) { std::cout << word << " "; } std::cout << std::endl; // 故意设置一个调试点 int sum = 0; for (int i = 1; i <= 10; ++i) { sum += i; // 在这里设置断点 } std::cout << "Sum from 1 to 10 is: " << sum << std::endl; return 0; } EOF

创建CMakeLists.txt：

cat > CMakeLists.txt << 'EOF' cmake_minimum_required(VERSION 3.10) project(MyCMakeProject VERSION 1.0.0 LANGUAGES CXX) # 设置C++标准 set(CMAKE_CXX_STANDARD 17) set(CMAKE_CXX_STANDARD_REQUIRED ON) # 添加可执行文件 add_executable(${PROJECT_NAME} src/main.cpp) # 设置输出目录（可选） set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin) # 如果有需要链接的库，使用 target_link_libraries # target_link_libraries(${PROJECT_NAME} PRIVATE some_library) EOF

5.2 使用VS Code打开并配置

在终端中，用VS Code打开当前目录：

code .

VS Code打开后，底部状态栏会提示“CMake项目未配置”。点击它，或者按Ctrl+Shift+P输入“CMake: Configure”，选择之前配置好的Kit（比如GCC）。

CMake配置成功后，状态栏会显示构建目标（MyCMakeProject）和构建类型（Debug）。点击状态栏的“Build”按钮（一个小齿轮）开始构建。构建输出会在终端面板显示。

5.3 运行与调试

构建成功后，你可以在终端中运行程序：

./build/bin/MyCMakeProject

但更强大的是使用调试功能。打开src/main.cpp文件，在第14行sum += i;的左侧点击，设置一个断点（会出现红点）。

按F5启动调试。VS Code会自动切换到调试视图，程序会在断点处暂停。此时你可以：

  • 查看变量：在左侧“变量”窗口，看到i和sum的当前值。
  • 逐步执行：使用顶部的调试控制栏（或F10单步跳过，F11单步进入）。
  • 调用堆栈：查看函数调用链。
  • 调试控制台：可以输入GDB命令进行更底层的控制。

这就是一个完整的、现代化的C/C++开发工作流。

6. 进阶配置与效率工具

基础环境搭好后，一些“利器”能让你事半功倍。

6.1 代码格式化与静态分析

保持代码风格一致至关重要。我们可以配置clang-format和clang-tidy。

  1. Clang-Format：在项目根目录创建.clang-format文件，定义代码风格（如基于Google、LLVM风格或自定义）。然后在VS Code中安装“Clang-Format”插件，并设置保存时自动格式化。

    # 生成一个默认的LLVM风格配置文件 clang-format-16 -style=llvm -dump-config > .clang-format

    在VS Code设置中（Ctrl+,）搜索“Format On Save”，勾选。并确保C/C++插件的格式化程序是clang-format。

  2. Clang-Tidy：用于静态代码分析，检查潜在错误、编码规范等。在CMakeLists.txt中启用：

    # 在add_executable之后 set(CMAKE_CXX_CLANG_TIDY "clang-tidy-16;-checks=*;")

    这样，每次构建时都会运行clang-tidy检查。你也可以在VS Code中安装“Clang-Tidy”插件，在编辑时实时查看警告。

6.2 版本控制集成

VS Code对Git有出色的内置支持。确保你的项目已初始化Git仓库（git init），源代码管理面板会显示所有更改。建议配置.gitignore文件，忽略build/目录、.vscode/中的部分文件（如settings.json可能包含个人偏好）等。

一个基础的C++项目.gitignore示例：

# 构建目录 build/ */build/ # IDE .vscode/ !.vscode/settings.json !.vscode/tasks.json !.vscode/launch.json !.vscode/extensions.json # 编译产物 *.o *.so *.a *.exe *.out

6.3 处理中文乱码问题

如果你在代码或输出中遇到中文乱码（这在处理文件路径或打印中文时常见），通常是编码问题。

  1. 源代码文件编码：确保你的.cpp和.h文件以UTF-8编码保存。在VS Code右下角状态栏可以查看和更改编码。
  2. 终端编码：Ubuntu终端默认使用UTF-8，一般没问题。如果输出乱码，可以检查环境变量：
    echo $LANG # 应该是类似 zh_CN.UTF-8 或 en_US.UTF-8
    如果不是，可以在~/.bashrc或~/.zshrc中添加export LANG=en_US.UTF-8或export LANG=zh_CN.UTF-8并重启终端。
  3. 编译器警告：GCC/Clang在编译含有非ASCII字符的源文件时，如果没有指定编码，可能会警告。可以在编译命令或CMake中指定：
    add_compile_options(-finput-charset=UTF-8 -fexec-charset=UTF-8)

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

即使按照步骤操作，也难免会遇到问题。这里记录一些高频问题和解决方法。

7.1 软件包安装失败或版本冲突

问题：sudo apt install时出现“无法定位软件包”或“依赖关系不满足”。

排查：

  1. 更新软件源：首先确保执行了sudo apt update。
  2. 检查拼写：包名严格区分大小写且必须完全正确。使用apt search <关键词>来查找准确的包名。
  3. PPA源问题：如果你添加了第三方PPA（如LLVM、Kitware），可能因为Ubuntu版本代号不匹配而失败。检查add-apt-repository命令中的$(lsb_release -cs)是否输出了正确的版本代号（如jammy对应22.04）。
  4. 依赖冲突：有时安装新版本会与旧版本冲突。尝试先卸载旧版本，或者使用aptitude工具进行更智能的依赖解决：sudo apt install aptitude && sudo aptitude install <包名>。

7.2 VS Code IntelliSense不工作或报错

问题：代码没有自动补全，或者头文件下有红色波浪线提示“无法打开源文件”。

排查：

  1. 重新扫描：按Ctrl+Shift+P，运行“C/C++: 重新扫描工作空间”。
  2. 检查配置提供者：确保c_cpp_properties.json中"configurationProvider"设置为"ms-vscode.cmake-tools"（对于CMake项目），或者"includePath"和"compilerPath"设置正确。
  3. 清除缓存：删除项目下的.vscode/ipch文件夹（IntelliSense持久化缓存），然后重启VS Code。
  4. 查看日志：打开C/C++插件的输出日志（Ctrl+Shift+P-> “C/C++: 打开日志”），里面通常有详细的错误信息。

7.3 CMake配置失败

问题：CMake配置时提示找不到编译器、找不到包（如find_package失败）。

排查：

  1. 编译器路径：确保你选择的Kit中的编译器路径是有效的。可以在终端中用which gcc或which clang确认。
  2. 开发包未安装：find_package寻找的是开发包（-dev后缀）。例如，寻找OpenCV需要安装libopencv-dev，而不仅仅是opencv。
  3. 指定CMake模块路径：如果库安装在非标准路径（如/usr/local），可能需要告诉CMake去哪里找。在CMakeLists.txt中或配置时添加：
    set(CMAKE_PREFIX_PATH "/usr/local/lib/cmake/SomeLibrary;$ENV{CMAKE_PREFIX_PATH}")
  4. 查看CMake缓存：在build/目录下有一个CMakeCache.txt文件，里面记录了所有配置变量，是排查问题的宝贵资料。

7.4 调试器无法启动或断点不生效

问题：按F5后调试器一闪而过，或者断点处没有暂停（断点显示为灰色空心圆）。

排查：

  1. 程序路径：检查launch.json中的"program"路径是否正确指向了编译出的可执行文件。对于CMake项目，路径通常是${workspaceFolder}/build/bin/你的程序名。
  2. 调试符号：确保编译时添加了-g选项。在CMake中，Debug构建类型会自动添加。检查你的构建类型是否为Debug。
  3. 预启动任务：如果launch.json中配置了preLaunchTask，确保对应的tasks.json中的任务能成功构建出最新的可执行文件。
  4. GDB权限：有时调试需要特殊权限。可以尝试在launch.json的setupCommands中添加：
    { "text": "set disable-randomization off", "ignoreFailures": true }
  5. 检查程序输出：在调试控制台查看是否有错误输出。有时程序在启动初期就崩溃了。

7.5 多版本编译器管理

问题：系统中有多个GCC或Clang版本，如何切换？

解决方案：使用update-alternatives工具。

# 以gcc为例，注册不同版本 sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-11 110 sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-12 120 # 交互式选择默认版本 sudo update-alternatives --config gcc # 对g++、gfortran等做同样操作

对于Clang，方法类似。更简单的方式是在CMake或编译命令中直接指定编译器绝对路径，如CC=/usr/bin/gcc-11 CXX=/usr/bin/g++-11 cmake ..。

环境搭建本身就是一个学习和排错的过程。每次遇到问题并解决，你对这套工具链的理解就会加深一层。记住，一个稳定、顺手的环境是高效开发的基石，花时间把它打磨好，绝对物超所值。

编程学习 学习日记 实战经验
← 返回列表