在C++项目开发中，随着代码量增加，把所有内容写在一个文件里会变得难以维护。多文件编译是将程序拆分成多个源文件（.cpp）和头文件（.h 或 .hpp），然后分别编译再链接成可执行文件的过程。这样做有利于模块化、协作开发和代码复用。
多文件编译的基本结构
一个典型的多文件C++项目通常包含：
- main.cpp：程序入口，包含 main 函数
- function.cpp：实现某些功能函数
- function.h：声明这些函数，供其他文件包含
例如：
// function.h#ifndef FUNCTION_H
#define FUNCTION_H
void printHello();
#endif // FUNCTION_H
// function.cpp
#include iostream>
#include "function.h"
void printHello() {
std::cout }
// main.cpp
#include "function.h"
int main() {
printHello();
return 0;
}
使用 g++ 进行多文件编译
最简单的方式是在命令行中一次性编译所有 .cpp 文件：
立即学习“C++免费学习笔记（深入）”；
g++ main.cpp function.cpp -o program这会将两个源文件编译并链接为可执行文件 program。
也可以分步进行：
- 先编译为目标文件（.o）：
g++ -c main.cpp
g++ -c function.cpp - 再链接目标文件：
g++ main.o function.o -o program
分步的好处是：只有修改过的文件才需要重新编译，提高效率。
头文件的正确使用与防止重复包含
头文件用于声明函数、类、变量等，被多个源文件共享。必须使用头文件守卫或 #pragma once 防止重复包含：
#ifndef MATH_UTILS_H
#define MATH_UTILS_H
int add(int a, int b);
#endif
或者更简洁地：
#pragma onceint add(int a, int b);
推荐使用 #pragma once，现代编译器都支持，写起来更简单。
项目组织建议
对于稍大的项目，合理组织目录结构很重要：
- src/：存放所有 .cpp 源文件
- include/：存放所有 .h 头文件
- build/：存放编译生成的目标文件和可执行文件
- CMakeLists.txt 或 Makefile：自动化构建脚本
示例目录结构：
project/├── include/
│ └── utils.h
├── src/
│ ├── utils.cpp
│ └── main.cpp
├── build/
└── CMakeLists.txt
配合 Makefile 可以简化编译命令：
# MakefileCXX = g++
CXXFLAGS = -Wall -std=c++17
INCLUDE = -Iinclude
SRCS = src/main.cpp src/utils.cpp
TARGET = build/program
$(TARGET): $(SRCS)
$(CXX) $(CXXFLAGS) $(INCLUDE) $^ -o $@
之后只需运行 make 即可完成编译。
基本上就这些。掌握多文件编译是迈向实际C++开发的第一步，理解编译链接过程对排查错误也很有帮助。
