如何按功能自定义拆分C++代码，规避.h/.cpp配对模式？

核心思路 #

用一个公共头文件统一存放所有功能模块的函数声明、全局变量声明和必要的第三方/系统头文件引用，每个功能类别对应单独的.cpp文件实现具体逻辑。主文件仅需包含这个公共头文件，彻底替代繁琐的链式头文件包含结构。

具体实现步骤 #

1. 创建公共头文件（比如common.h）

必须加头文件保护宏避免重复包含，里面集中管理所有公共依赖、声明：

// common.h
#ifndef COMMON_H
#define COMMON_H

// 引入必要的系统/第三方库头文件
#include <bluetooth.h>
#include <json.hpp>
#include <math.h>

// 全局变量声明（用extern，实际定义放在单独的cpp文件中）
extern int global_device_id;
extern bool is_bluetooth_connected;

// 蓝牙功能模块函数声明
bool bluetooth_init();
void bluetooth_send_data(const char* data);

// JSON处理模块函数声明
nlohmann::json parse_json(const char* raw_data);
std::string json_to_string(const nlohmann::json& json_obj);

// 数学计算模块函数声明
float calculate_distance(float x1, float y1, float x2, float y2);
int clamp_value(int value, int min, int max);

#endif // COMMON_H

2. 编写功能实现文件

每个功能类别对应一个.cpp，只需包含common.h即可实现对应的函数：

• 蓝牙功能实现：bluetooth.cpp

#include "common.h"

bool bluetooth_init() {
    // 蓝牙初始化具体逻辑
    is_bluetooth_connected = true;
    return true;
}

void bluetooth_send_data(const char* data) {
    // 蓝牙数据发送逻辑
}

• JSON功能实现：json_utils.cpp

#include "common.h"

nlohmann::json parse_json(const char* raw_data) {
    // JSON解析逻辑
    return nlohmann::json::parse(raw_data);
}

std::string json_to_string(const nlohmann::json& json_obj) {
    // JSON转字符串逻辑
    return json_obj.dump();
}

• 数学计算实现：math_utils.cpp

#include "common.h"

float calculate_distance(float x1, float y1, float x2, float y2) {
    return sqrt(pow(x2-x1, 2) + pow(y2-y1, 2));
}

int clamp_value(int value, int min, int max) {
    if (value < min) return min;
    if (value > max) return max;
    return value;
}

3. 全局变量的定义

全局变量不能在头文件中直接定义（会导致重复定义错误），需放在单独的.cpp文件中，比如globals.cpp：

#include "common.h"

// 全局变量的实际定义
int global_device_id = 1001;
bool is_bluetooth_connected = false;

4. 主文件调用

main.cpp只需包含common.h，直接调用所有功能函数：

#include "common.h"

int main() {
    bluetooth_init();
    
    nlohmann::json data = parse_json("{\"name\":\"test\"}");
    bluetooth_send_data(json_to_string(data).c_str());
    
    float dist = calculate_distance(0,0,3,4);
    return 0;
}

编译注意事项 #

编译时要把所有.cpp文件都加入编译命令，比如用GCC：

g++ main.cpp bluetooth.cpp json_utils.cpp math_utils.cpp globals.cpp -o app -lbluetooth -ljsoncpp

（根据实际依赖的库调整链接参数）

方案优势 #

• 无需维护复杂的头文件包含链，所有模块仅依赖common.h
• 新增功能模块只需两步：在common.h添加函数声明、新建对应.cpp实现，编译时加入该文件即可，完全不用修改现有文件的包含关系
• 避免链式包含带来的重复定义、头文件顺序冲突等问题

内容的提问来源于stack exchange，提问作者Sam