Linux 下 C++ 开发环境搭建

这是最标准、最通用、最稳定的 Linux C++ 开发环境搭建文档，适用于：

Ubuntu 20.04 / 22.04
Debian
CentOS 7 / 8
Fedora
虚拟机、云服务器、本地 Linux 系统

全程命令行操作，无图形界面也能搭建。

一、环境组成（必须安装的 4 类工具）

Linux C++ 开发环境 =

编译器：g++（GCC）
调试器：gdb
构建工具：make / cmake
编辑器：VS Code（图形）/ Vim（终端）

二、一步安装核心开发工具（必做）

Ubuntu / Debian 系列（最常用）

bash 复制代码

sudo apt update
sudo apt install -y build-essential gdb cmake git

CentOS / RHEL / Fedora

bash 复制代码

sudo yum update -y
sudo yum groupinstall -y "Development Tools"
sudo yum install -y gdb cmake git

三、验证是否安装成功

输入以下命令，出现版本号说明成功：

bash 复制代码

g++ --version
gdb --version
make --version
cmake --version

只要能输出版本号，环境就已经搭建完成！

四、第一个 C++ 程序（测试环境）

1. 创建 cpp 文件

bash 复制代码

vim test.cpp

2. 写入代码

cpp 复制代码

#include <iostream>
using namespace std;

int main() {
    cout << "Linux C++ 开发环境搭建成功！" << endl;
    return 0;
}

3. 编译

bash 复制代码

g++ test.cpp -o test

4. 运行

bash 复制代码

./test

看到输出：

复制代码

Linux C++ 开发环境搭建成功！

✅ 环境正常！

五、多文件项目编译（Makefile 实战）

项目结构

复制代码

demo/
  main.cpp
  func.h
  func.cpp

main.cpp

cpp 复制代码

#include "func.h"
int main() {
    show();
    return 0;
}

func.h

cpp 复制代码

#pragma once
void show();

func.cpp

cpp 复制代码

#include <iostream>
#include "func.h"

void show() {
    std::cout << "多文件编译成功！" << std::endl;
}

Makefile 文件

makefile 复制代码

all:
	g++ main.cpp func.cpp -o demo

clean:
	rm -f demo

编译运行

bash 复制代码

make
./demo

六、现代 CMake 项目编译（企业级标准）

CMakeLists.txt

cmake 复制代码

cmake_minimum_required(VERSION 3.10)
project(demo)

# C++17 标准
set(CMAKE_CXX_STANDARD 17)

add_executable(demo main.cpp func.cpp)

编译流程

bash 复制代码

mkdir build
cd build
cmake ..
make
./demo

七、Linux 下调试程序（GDB 必备）

编译时加调试信息

bash 复制代码

g++ -g test.cpp -o test

启动 GDB

bash 复制代码

gdb ./test

常用 GDB 命令

复制代码

l         # 查看代码
b 行号     # 设置断点
run       # 运行
n         # 下一步
p 变量名   # 打印变量
q         # 退出

八、图形化开发：VS Code 安装（可选）

如果你有图形界面，强烈推荐 VS Code。

下载

bash 复制代码

wget -O code.deb https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64

安装

bash 复制代码

sudo dpkg -i code.deb
sudo apt -f install

必装插件

C/C++（微软官方）
CMake Tools
Code Runner

九、必备 Linux 开发命令

bash 复制代码

ls          # 查看文件
cd          # 进入目录
g++         # 编译
make        # 构建
cmake       # 生成构建文件
gdb         # 调试
ldd         # 查看程序依赖库

十、最常见问题

1. 找不到 g++

bash 复制代码

sudo apt install build-essential

2. 权限不够

bash 复制代码

sudo 命令

3. 运行程序提示 command not found

必须加 ./

bash 复制代码

./test

4. 中文乱码

Linux 默认 UTF-8，确保代码保存为 UTF-8 即可。

十一、最终总结（最核心）

Linux C++ 环境搭建只需要 1 条命令：

bash 复制代码

sudo apt install -y build-essential gdb cmake git

编译运行：

bash 复制代码

g++ test.cpp -o test
./test

多文件：

Makefile / CMake