C++ 跨平台移植實戰：分層隔離、宏封裝、構建系統

編輯：關於C語言

為什麼移植會痛？

OS API 差異（Win32 vs POSIX）
編譯器擴展不一致（MSVC vs GCC vs Clang）
標準庫功能有限，必須調用平台 API
數據類型大小、字節序、對齊、路徑分隔符、換行符各不同

核心策略：分層隔離 + 介面導向


+---------------------------+
|  平台無關業務邏輯 (main)  |  ← 只調用跨平台介面
+---------------------------+
|  跨平台抽象層 (platform)  |  ← 統一介面聲明
+---------------------------+
|  Win32 實現 | Linux 實現  |  ← 各平台具體實現
+---------------------------+

實施步驟

1. 定義統一介面 `platform.hpp`


// platform.hpp
#pragma once
#include <string>
using handle_t = void*;  // 不透明句柄

handle_t my_load_library(const std::string& name);
void my_free_library(handle_t h);
void* my_get_symbol(handle_t h, const char* sym);

2. 平台專屬實現分檔


// win32_platform.cpp
#include "platform.hpp"
#include <windows.h>
handle_t my_load_library(const std::string& name) {
    return LoadLibraryA(name.c_str());
}
void my_free_library(handle_t h) { FreeLibrary((HMODULE)h); }
void* my_get_symbol(handle_t h, const char* sym) {
    return GetProcAddress((HMODULE)h, sym);
}

// linux_platform.cpp
#include "platform.hpp"
#include <dlfcn.h>
handle_t my_load_library(const std::string& name) {
    return dlopen(name.c_str(), RTLD_LAZY);
}
void my_free_library(handle_t h) { dlclose(h); }
void* my_get_symbol(handle_t h, const char* sym) {
    return dlsym(h, sym);
}

3. 構建系統自動選擇


# CMakeLists.txt
if(WIN32)
    set(PLATFORM_SRC win32_platform.cpp)
elseif(UNIX)
    set(PLATFORM_SRC linux_platform.cpp)
endif()
add_library(platform ${PLATFORM_SRC})
target_link_libraries(main PRIVATE platform)

或用 Makefile：include buildenv/$(OS).inc 覆蓋編譯器/標誌。

關鍵細節清單

類別	注意點
文件路徑	用 `boost::filesystem` 或 `std::filesystem` (C++17) 抽象分隔符
大小寫敏感	Linux 區分，Windows 不區分，資源載入統一小寫
字節序	網絡傳輸用 `htonl/ntohl`，文件存儲固定大端
對齊	ARM 等架構不對齊會 SIGBUS，用 `memcpy` 而非強轉指標
類型大小	用 `int32_t` 等固定寬度類型，避免 `long` 32/64 差異
符號可見性	Windows 需 `__declspec(dllexport)`，Linux 預設導出，用宏統一
換行符	文本模式 `fopen` 自動轉換，二進制模式保持原樣

避坑指南

**慎用編譯器擴展**（GCC 屬性、MSVC __declspec），必要時用宏隔離。
**避免準標準函數**（strdup, alloca, snprintf 早期不標準），或自行實現兼容層。
**全域對象構造順序未定義**——跨動態庫更亂，改用單例懶加載。
**第三方庫版本差異**（如 OpenSSL 1.1 vs 3.0 API 不兼容），用 pkg-config 或 find_package 鎖定版本。