编写兼容Linux与Windows的C++代码如何正确组织文件结构？

编译失败直接原因 #

• 你提供的Generic通用实现代码末尾存在多余的#endif，没有对应的#if/#ifdef预处理开头，属于语法错误。不同编译器对这类未匹配预处理指令的检查严格度不同，是导致Windows端MinGW编译失败的核心诱因，先删除这个冗余的#endif即可解决该问题。
• 额外检查CodeBlocks的Windows构建目标配置，确认是否将Generic文件夹下的源文件加入了编译列表，若遗漏会出现函数未定义的链接错误。

推荐跨平台代码组织方案 #

完全不需要把所有代码塞到同一个文件里用#ifdef判断，这种写法会随代码量膨胀快速变得难以维护，可采用「接口统一、实现分离、编译期选择」的方案，具体结构如下：

头文件层 #

保留统一的SystemTools.h，仅对外暴露类的所有方法声明（含平台相关、通用方法），可以将平台相关的头文件引入下移到对应平台的实现文件中，进一步简化头文件：

#pragma once
#include <string>
#include <iostream>

class SystemTools
{
public:
    // 平台相关方法：延迟指定秒数
    static void sleep(int delay);
    // 通用方法：延迟指定分钟数
    static void sleepMin(int delay);
private:
};

平台相关实现层 #

分别在linux、windows文件夹下存放对应平台的实现文件，不需要在实现文件中加平台判断的#ifdef：

• linux/SystemTools_linux.cpp：

#include <unistd.h>
#include "../SystemTools.h"

void SystemTools::sleep(int delay)
{
    usleep(delay*1000000);
}

• windows/SystemTools_win.cpp：

#include <Windows.h>
#include "../SystemTools.h"

void SystemTools::sleep(int delay)
{
    Sleep(delay*1000);
}

通用实现层 #

Generic文件夹下存放所有无平台依赖的方法实现，所有平台编译时都需要加入该文件，无需任何平台相关预处理：

#include "../SystemTools.h"

void SystemTools::sleepMin(int delay)
{
    sleep(delay*60);
}

编译配置层 #

在构建工具中配置不同平台的构建目标：

• Linux构建目标：加入linux/SystemTools_linux.cpp + Generic/SystemTools_generic.cpp参与编译
• Windows构建目标：加入windows/SystemTools_win.cpp + Generic/SystemTools_generic.cpp参与编译

该方案优势明显：

• 无冗余的#ifdef嵌套，代码可读性、可维护性大幅提升
• 新增平台相关方法仅需在两个平台实现文件中补充对应逻辑，新增通用方法仅需修改通用实现文件，互不干扰
• 适配所有主流构建工具，不管是CodeBlocks、Makefile还是CMake都可以很轻松实现配置

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