ubuntu c++项目如何配置环境

下面按从零开始的思路，给你一个在 Ubuntu 上配置 C++ 开发环境的完整指南，适合新手到中大型项目，涵盖 编译、构建、IDE、依赖管理 等常见场景。

一、基础环境准备（必做）

1️⃣ 安装编译工具链

sudo apt update
sudo apt install -y build-essential

包含：

• gcc / g++（编译器）
• make
• 基础开发库

验证：

g++ --version
make --version

2️⃣ 安装常用工具（推荐）

sudo apt install -y cmake gdb git

二、最简单的 C++ 项目（手动编译）

示例项目结构

hello/
├── main.cpp

main.cpp

#include <iostream>

int main() {
    std::cout << "Hello Ubuntu C++" << std::endl;
    return 0;
}

编译 & 运行

g++ main.cpp -o hello
./hello

三、使用 Makefile（中等项目）

项目结构

project/
├── src/
│   └── main.cpp
├── Makefile

Makefile 示例

CXX = g++
CXXFLAGS = -std=c++17 -Wall

TARGET = app
SRC = src/main.cpp

$(TARGET):
	$(CXX) $(CXXFLAGS) $(SRC) -o $(TARGET)

clean:
	rm -f $(TARGET)

使用

make
./app
make clean

四、使用 CMake（✅ 强烈推荐）

1️⃣ 安装 CMake

sudo apt install cmake

2️⃣ 项目结构（推荐）

project/
├── CMakeLists.txt
├── src/
│   └── main.cpp
├── build/

3️⃣ CMakeLists.txt 示例

cmake_minimum_required(VERSION 3.10)
project(MyProject)

set(CMAKE_CXX_STANDARD 17)

add_executable(app src/main.cpp)

4️⃣ 编译流程（out-of-source build）

mkdir build
cd build
cmake ..
make
./app

✅ 优点

• 跨平台
• 适合中大型项目
• 自动管理依赖和编译选项

五、使用 IDE（可选但推荐）

✅ VS Code（最流行）

sudo snap install code --classic

推荐插件

• C/C++
• CMake Tools
• CMake
• GDB Debug

配置 .vscode/tasks.json

用于一键编译（CMake 项目）：

{
  "version": "2.0.0",
  "tasks": [
    {
      "label": "cmake build",
      "type": "shell",
      "command": "cd build && cmake .. && make",
      "group": "build"
    }
  ]
}

✅ CLion（专业 C++ IDE）

• 自带 CMake 支持
• 自动配置工具链
• 适合大型工程

六、安装第三方库（常见方式）

1️⃣ apt 安装（最简单）

sudo apt install libopencv-dev
sudo apt install libboost-all-dev

CMake 中使用：

find_package(OpenCV REQUIRED)
target_link_libraries(app OpenCV::OpenCV)

2️⃣ vcpkg（跨平台依赖管理）

git clone https://github.com/microsoft/vcpkg.git
./vcpkg/bootstrap-vcpkg.sh

示例：

./vcpkg/vcpkg install fmt

七、调试配置（GDB）

编译时加调试信息

g++ -g main.cpp -o app

使用 GDB

gdb ./app

VS Code 中可直接 F5 调试。

八、推荐项目结构（工程化）

project/
├── CMakeLists.txt
├── include/        # 头文件
├── src/            # 源文件
├── third_party/    # 第三方库
├── build/          # 编译目录
├── tests/          # 测试代码

九、常见问题

❓ g++ 找不到头文件

sudo apt install libc++-dev

❓ CMake 版本太低

sudo apt install cmake
# 或官方下载新版

十、我可以继续帮你

你可以告诉我：

• ✅ 是新手还是已有项目
• ✅ 项目规模（单文件 / 多模块 / 第三方库）
• ✅ 是否用 OpenCV / ROS / Qt / 嵌入式
• ✅ Ubuntu 版本（20.04 / 22.04 / 24.04）

我可以直接给你 定制 CMake / Makefile / VS Code 配置。