Debian系统中C++配置步骤是什么

在Debian系统里配置C++环境，操作上其实非常标准，无非就是装编译器、装调试器、写个Hello World跑一遍，然后根据项目复杂度决定是用Makefile还是CMake。很多人一上来就被网上各种教程绕晕了，其实核心流程就那么几步。下面我们直接开干。

一 安装编译工具与调试器

先把软件索引更新一下，然后装上基础开发包和调试器：

sudo apt update && sudo apt install build-essential gdb

build-essential 这个包很关键，它把 gcc、g++、make 这些东西一次性给你装好，省得一个一个去折腾。gdb 是调试器，后面排查问题的时候你就会知道它有多重要了。装完之后，直接在终端里就能用 g++ 编译代码、用 gdb 进行调试。

二 验证安装与环境检查

装完之后别急着写代码，先确认一下工具链是不是真的就绪了。

• 检查编译器版本：运行 gcc --version 和 g++ --version，如果能看到 GCC/G++ 的版本号，说明安装成功。
• 检查环境变量：运行 echo $PATH，正常情况下 /usr/bin 已经包含在路径里了，不需要手动配置。如果你之前手动装过其他版本到自定义目录，那才需要在 ~/.bashrc 或 ~/.profile 里追加路径，然后 source 一下让它生效。

三 编译与运行第一个程序

这一步没什么特别的，拿个经典例子验证一下整个链路是否通畅。

先创建一个 hello.cpp 文件，内容如下：

#include 
int main() {
    std::cout << "Hello, Debian C++\n";
    return 0;
}

然后执行编译命令：

g++ -o hello hello.cpp

这里多说一句：建议加上 -Wall -g 参数。-Wall 会帮你打开常见警告，很多时候这些小警告能提前帮你堵住潜在的坑；-g 则是生成调试信息，方便后面用 gdb 排查问题。

编译完之后运行：

./hello

如果能在终端看到 "Hello, Debian C++"，说明环境配置已经没问题了。值得注意的是，C++ 源文件一定要用 g++ 来链接，因为它会自动链接 C++ 标准库，用 gcc 的话会多出一堆麻烦。

四 多文件项目与构建工具

单文件项目用编译命令直接搞定，但一旦项目变大了，手动敲命令就不现实了。这时候就需要构建工具来帮忙。

使用 Makefile

一个典型的 Makefile 示例如下：

CXX:= g++
CXXFLAGS := -Wall -Wextra -std=c++17 -g
TARGET := app
SRCS := main.cpp util.cpp
OBJS := $(SRCS:.cpp=.o)

$(TARGET): $(OBJS)
	$(CXX) $(CXXFLAGS) -o $@ $^

%.o: %.cpp
	$(CXX) $(CXXFLAGS) -c $< -o $@

clean:
	rm -f $(OBJS) $(TARGET)

用法很简单：make 编译，make clean 清理。

使用 CMake

如果你的项目跨平台需求比较强，或者成员更喜欢图形化一点的构建工具，CMake 是更好的选择。首先在项目根目录创建 CMakeLists.txt：

cmake_minimum_required(VERSION 3.10)
project(MyApp LANGUAGES CXX)
set(CMAKE_CXX_STANDARD 17)
add_executable(myapp main.cpp util.cpp)

然后执行构建：

mkdir -p build && cd build
cmake ..
make
./myapp

关于调试：只要编译时加了 -g 参数，就可以直接用 gdb ./myapp 来进行断点设置、单步执行和变量查看，非常方便。

五 多版本 GCC 切换与 VS Code 配置

多版本 GCC 切换

有时候你需要在不同版本的 GCC 之间切换，比如为了兼容某些旧项目。Debian 下的标准做法是用 update-alternatives 来管理。

假设你装好了 gcc-12/g++-12 和 gcc-13/g++-13，先注册候选版本：

sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-12 120 --sla ve /usr/bin/g++ g++ /usr/bin/g++-12
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-13 130 --sla ve /usr/bin/g++ g++ /usr/bin/g++-13

这里的优先级数值越大，默认选中的概率越高。然后运行 sudo update-alternatives --config gcc，就能交互式地选择默认版本了。同理，g++ 也可以这么配置。

VS Code 快速配置

如果你习惯用 VS Code 写 C++，配置起来也不复杂。先安装好 VS Code 和 C/C++ 扩展（就是那个 ms-vscode.cpptools）。然后按 F5 或者点击"运行与调试"，选择 C++ (GDB/LLDB)，VS Code 会自动帮你生成 .vscode/launch.json 和 .vscode/tasks.json。

如果是多文件项目，建议额外补充一个 c_cpp_properties.json，在里面配好 includePath，这样代码补全和头文件索引就不会出错了。