寫跨平台 C/C++ 程式碼時,最基礎的功夫是知道「編譯器幫我預先定義了哪些巨集」。這些預定義巨集是條件編譯的唯一依據——沒有它,同一份原始碼就無法針對不同平台選擇不同的 API 或型別。
下表按「機器 / 製造商 / 作業系統 / 編譯器 / 可識別的預定義巨集」整理常見組合。方括號表示該巨集在某些版本或設定下才會出現。
| 機器 | 製造商 | 作業系統 | 編譯器 | 可識別的預定義巨集 |
|---|---|---|---|---|
| AMIGA | Commodore | AMIGA-OS (AMIGADOS) | GNU | amiga 或 AMIGA、__GNUC__,可能還有 MC68000 或 AMIGA3000 |
| 任意 | 任意 | UNIX | GNU | unix、__GNUC__、… |
| 任意 | 任意 | UNIX | CC | unix、… |
| Amiga 3000 | Commodore | Amiga UNIX 2.1 SVR4.0 | GNU | unix、__unix__、AMIX、__AMIX__、__svr4__、m68k、__m68k__、__motorola__、__GNUC__ |
| SUN-3 | Sun | SUN-OS3 (UNIX BSD 4.2) | GNU | sun、unix、mc68020、__GNUC__ |
| SUN-3 | Sun | SUN-OS4 (UNIX SUNOS 4.1) | GNU | sun、unix、mc68020、__GNUC__ |
| SUN-386 | Sun | SUN-OS4 (UNIX SUNOS 4.0) | GNU | sun、unix、sun386、i386、__GNUC__ |
| SUN-386 | Sun | SUN-OS4 (UNIX SUNOS 4.0) | CC | sun、unix、sun386、i386 |
| SUN-4 | Sun | SUN-OS4 (UNIX SUNOS 4.1) | GNU | sun、unix、sparc、__GNUC__ |
| SUN-4 | Sun | SUN-OS4 (UNIX SUNOS 4.1) | CC | sun、unix、sparc |
| SUN-4 | Sun | SUN-OS5 (UNIX Solaris) | GCC | sun、unix、sparc、__GNUC__ |
| UltraSPARC | Sun | Solaris 7 (SUNOS 5.7) | CC | sun、unix、__sparc、__sparcv9 |
| UltraSPARC | Sun | Solaris 7 (SUNOS 5.7) | GCC | sun、unix、__sparc、__arch64__、__GNUC__ |
| IBM-PC/386 | 任意 | SUN-OS5 (UNIX Solaris) | GCC | sun、unix、__svr4__、i386、__GNUC__ |
| HP9000-300 | Hewlett-Packard | NetBSD 0.9 (UNIX BSD 4.3) | GNU | unix、__NetBSD__、mc68000、__GNUC__ |
| HP9000-300 | Hewlett-Packard | HP-UX 8.0 (UNIX SYS V) | GNU | [__]hpux、[__]unix、[__]hp9000s300、mc68000、__GNUC__ |
| HP9000-800 | Hewlett-Packard | HP-UX 8.0 (UNIX SYS V) | GNU | [__]hpux、[__]unix、[__]hp9000s800 |
| IRIS | Silicon Graphics | IRIX (UNIX SYS V 3.2) | GNU | unix、SVR3、mips、sgi、__GNUC__ |
| IRIS | Silicon Graphics | IRIX (UNIX SYS V) | cc -ansi | [__]unix、[__]SVR3、[__]mips、[__]sgi |
| IRIS | Silicon Graphics | IRIX 5 (UNIX SYS V 4) | GNU | [__]unix、[__]SYSTYPE_SVR4、[__]mips、[__]host_mips、[__]MIPSEB、[__]sgi、__DSO__、[__]_MODERN_C、__GNUC__ |
| DECstation 5000 | DEC | RISC/OS (Ultrix V4.2A) | GNU | unix、[__]mips、[__]ultrix |
| DG-UX 88k | Data General | DG/UX | GNU | unix、m88000、DGUX |
| DEC Alpha | DEC | OSF/1 1.3 | cc | [unix,] __unix__、__osf__、__alpha |
| DEC Alpha | DEC | OSF/1 1.3 | GNU | unix、__unix__、__osf__、__alpha、__alpha__、_LONGLONG |
| Apple MacII | Apple | A/UX (UNIX SYS V 2) | GNU | [__]unix、[__]AUX、[__]MacII、[__]m68k、mc68020、mc68881、__GNUC__ |
| NeXT | NeXT | NeXTstep 3.1 (UNIX) | cc | NeXT、m68k;NEXTAPP 用於 NeXTstep Application |
| PowerPC | Apple | Mach 3.0 + MkLinux | GNU | unix、__powerpc__、__PPC__、_ARCH_PPC、_CALL_SYSV、__ELF__、__Linux__ |
| PowerPC | Apple | Mach + Rhapsody | cc | __MacH__、__APPLE__、__ppc[__]、__GNUC__、__APPLE_CC__ |
| PowerPC | Apple | Mach + MacOS X | cc | __MacH__、__APPLE__、__ppc__、__GNUC__、__APPLE_CC__ |
| Sequent | Sequent | PTX 3.2.0 V2.1.0 i386 (SYS V) | GNU | unix、i386、_SEQUENT_、__GNUC__ |
| Sequent | Sequent | PTX V4.1.3 | GNU | unix、i386、_SEQUENT_、__svr4__、__GNUC__ |
| Convex C2 | Convex | ConvexOS 10.1 | GNU | __convex__、__GNUC__ |
| IBM RS/6000 | IBM | AIX 3.2 | GNU | _AIX、_AIX32、_IBMR2、__CHAR_UNSIGNED__、__GNUC__ |
| IBM-PC/386 | 任意 | Linux | GNU | unix、Linux、i386、__GNUC__ |
| IBM-PC/386 | 任意 | Linux | Intel 5.0 | __unix__、__Linux__、__INTEL_COMPILER、__ICC、__USLC__ |
| IBM-PC/386 | 任意 | 386BSD 0.1 (UNIX BSD 4.2) | GNU | unix、__386BSD__、i386、__GNUC__ |
| IBM-PC/386 | 任意 | NetBSD 0.9 (UNIX BSD 4.3) | GNU | unix、__NetBSD__、i386、__GNUC__ |
| IBM-PC/386 | 任意 | FreeBSD 4.0 (UNIX BSD 4.4) | GNU | unix、__FreeBSD__、i386、__GNUC__ |
| IBM-PC/386 | 任意 | EMX 0.9c (OS/2 上的 UNIX-like) | GNU | [unix,] i386、__GNUC__、__EMX__ |
| IBM-PC/386 | 任意 | Cygwin32 on WinNT/Win95 | GNU | _WIN32、__WINNT__、__CYGWIN32__、__POSIX__、_X86_、i386、__GNUC__ |
| IBM-PC/386 | 任意 | Mingw32 on WinNT/Win95 | GNU | _WIN32、__WINNT__、__MINGW32__、_X86_、i386、__GNUC__ |
| IBM-PC/386 | 任意 | WinNT/Win95 | MSVC 4.0 / 5.0 | _WIN32、_M_IX86、_MSC_VER |
| IBM-PC/386 | 任意 | WinNT/Win95 | Borland 5.0 | __WIN32__、_M_IX86、__TURBOC__、__BORLANDC__ |
| IBM-PC/386 | 任意 | WinNT/Win95 + Cygwin32 | GNU | _WIN32、__WINNT__、__CYGWIN32__、__POSIX__、__i386__、_X86_、__GNUC__ |
| IBM-PC/586 | 任意 | BeOS 5 | GNU | __BEOS__、__INTEL__、__i386__、_X86_、__GNUC__ |
| IBM-PC/586 | 任意 | HP NUE/ski、Linux (ia64) | GNU | unix、Linux、__ia64[__]、__GNUC__、__LP64__ |
| RM400 | Siemens-Nixdorf | SINIX-N 5.42 | c89 | unix、mips、MIPSEB、host_mips、sinix、SNI、_XPG_IV |
| Acorn Risc PC | Risc PC | RISC OS 3.x | GNU | [__]arm、[__]riscos、__GNUC__ |
| Acorn Risc PC | Risc PC | RISC OS 3.x | Norcroft | [__]arm、[__]riscos |
| APPLE IIGS | Apple | 未確認 | 未確認 | — |
這張表的歷史跨度很大,從 AMIGA、SUN-3 到 RISC OS 都有。今天實際開發中用得到的其實不多:
__clang__。_WIN64 則是 64 位元專用。注意是底線開頭、大寫。#if defined(__linux) || defined(__linux__)。__ENVIRONMENT_IPHONE_OS_VERSION_MIN_REQUIRED__ 或 TARGET_OS_IPHONE。不要偵測作業系統來決定型別寬度。Windows 是 LLP64(long 為 32 位元),Linux 與 macOS 是 LP64(long 為 64 位元)。判斷資料模型應該用 __LP64__ 或 _WIN64,而不是判斷作業系統名稱。
把平台判斷集中到一個 header。在專案裡建立一個 platform.h,把所有條件編譯集中處理,統一導出你自己定義的巨集(例如 MY_API、MY_CALLCONV)。程式碼其他地方只認自己的巨集,這樣要新增平台時只需改一個檔案。
用 #error 補上預設分支。每個條件編譯的最後都該有 #else #error "Unsupported platform"。少了這一段,未支援的平台會靜默地走進某個錯誤分支,症狀可能延後到執行期才爆發,非常難查。
查詢權威來源而非依賴記憶。GCC 與 Clang 都提供直接列出所有預定義巨集的方式:gcc -dM -E - < /dev/null 或 clang -dM -E - < /dev/null;MSVC 則可用 cl /showIncludes 搭配自寫的測試巨集。與其背這張表,不如在目標機器上跑一次指令,結果最準確。