一、跨平台编译概述

各位同学好，我是老张。今天咱们聊聊跨平台编译这个话题。说实话，我刚入行那会儿，觉得能在Windows上跑起来的程序就是好程序。直到有一次，客户说「我们团队都用Mac，你给编译个Mac版呗」——嗯，那会儿我才意识到，跨平台不是选择题，而是必答题。

什么是跨平台编译

跨平台编译，说白了就是「一套代码，到处编译」。你写一份C++源码，在Windows上能编译成exe，在Linux上能编译成ELF，在macOS上能编译成Mach-O。听起来简单？其实背后有不少门道。

我个人的理解是：跨平台编译不是让代码「一次编写，到处运行」——那是Java的玩法。C++的跨平台，是让代码「一次编写，到处编译」。区别在哪？前者靠虚拟机，后者靠编译器。C++更贴近硬件，所以跨平台的工作主要落在「构建系统」和「条件编译」上。

核心要点：跨平台编译 = 平台无关的源码 + 平台相关的构建配置 + 条件编译宏

为什么需要跨平台

你想想看，现在谁还用单一平台？

用户需求：Windows用户占大头，但Mac和Linux用户也不少。我做过一个统计，Qt应用的用户中，Mac用户占比能到15%-20%。你放弃这20%的用户？
开发环境：我自己就是Windows写代码，Linux做服务器测试，Mac做UI预览。三个平台来回切，如果代码不能跨平台，那得维护三份代码——疯了。
嵌入式场景：我在做工业控制项目时，上位机用Windows，下位机用ARM Linux。同一个通信协议库，必须两边都能编译。你说要不要跨平台？

我的经验：跨平台不是「锦上添花」，而是「雪中送炭」。尤其是Qt项目，Qt本身就是跨平台的，你不利用这个特性，那用Qt干嘛？直接用MFC不香吗？

主流跨平台工具链介绍

好，咱们来看看市面上主流的三个工具链。我三个都用过，各有各的脾气。

CMake

CMake是目前C++社区的「事实标准」。为什么？因为它成熟、稳定、生态好。我2015年开始用CMake，那时候它还不太友好，但现在——真香。

# CMakeLists.txt 示例
cmake_minimum_required(VERSION 3.16)
project(MyApp VERSION 1.0.0 LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 跨平台判断
if(WIN32)
    add_definitions(-DPLATFORM_WINDOWS)
elseif(APPLE)
    add_definitions(-DPLATFORM_MACOS)
else()
    add_definitions(-DPLATFORM_LINUX)
endif()

add_executable(myapp main.cpp)

CMake的优点很明显：

支持几乎所有平台和编译器
有庞大的模块库（FindXXX.cmake）
与IDE集成好（VS、CLion、Qt Creator都原生支持）

缺点呢？语法有点丑。说实话，CMake的语法设计得跟闹着玩似的，但用习惯了也就那样。

QMake

QMake是Qt的亲儿子。如果你只用Qt，QMake是最省心的选择。我早期做Qt项目时，一直用QMake，因为它跟Qt的qmake、moc、uic等工具配合得天衣无缝。

# .pro 文件示例
QT += core gui widgets
TARGET = MyApp
TEMPLATE = app

SOURCES += main.cpp \
           mainwindow.cpp
HEADERS += mainwindow.h

# 跨平台配置
win32 {
    LIBS += -lws2_32
}
unix {
    LIBS += -lpthread
}

QMake的优势：

与Qt深度集成，自动处理moc、uic、rcc
语法简单，上手快
对Qt模块的支持最完善

但QMake有个致命伤——它只适合Qt项目。如果你项目里混用了非Qt的库，QMake就有点力不从心了。而且Qt官方现在也在推CMake，QMake基本处于「维护模式」，不再有新功能。

注意：Qt 6开始，官方推荐使用CMake。QMake虽然还能用，但新项目不建议再用了。我曾经有个老项目，一直用QMake，后来想集成一个第三方库，折腾了两天才搞定——换成CMake，半小时完事。

Meson

Meson是后起之秀。我第一次接触Meson是在2018年，当时觉得「这玩意儿真快」。Meson用Python写构建配置，语法比CMake清爽多了。

# meson.build 示例
project('myapp', 'cpp',
  version: '1.0.0',
  default_options: ['cpp_std=c++17'])

# 跨平台判断
if host_machine.system() == 'windows'
  add_project_arguments('-DPLATFORM_WINDOWS', language: 'cpp')
elif host_machine.system() == 'darwin'
  add_project_arguments('-DPLATFORM_MACOS', language: 'cpp')
else
  add_project_arguments('-DPLATFORM_LINUX', language: 'cpp')
endif

executable('myapp', 'main.cpp')

Meson的优点：

速度快（比CMake快一个数量级）
语法简洁，可读性强
内置对Qt的支持（通过Qt模块）

缺点呢？生态还不够成熟。有些老库没有提供Meson的支持文件，得自己写wrap。我在一个嵌入式项目里用过Meson，体验不错，但团队里其他人不熟悉，最后还是换回了CMake。

工具链对比

特性	CMake	QMake	Meson
学习曲线	中等（语法奇葩）	低（简单直接）	低（Python风格）
Qt支持	好（Qt6推荐）	最好（原生支持）	好（需额外模块）
生态成熟度	最高	中等（仅Qt）	较低（但增长快）
构建速度	中等	快	最快
跨平台能力	极强	一般（依赖Qt）	强
IDE集成	最好	仅Qt Creator	较好

我的选择建议

说了这么多，到底选哪个？我个人习惯是这样的：

新项目、Qt 6：无脑选CMake。Qt官方都推了，你跟着走准没错。
老项目、Qt 5：如果项目已经用QMake跑得好好的，别折腾。等下次大重构再换。
纯C++项目（非Qt）：CMake或Meson二选一。我倾向于CMake，因为生态好，遇到问题好搜。
嵌入式或性能敏感项目：试试Meson。它的构建速度真的快，而且对交叉编译支持得很好。

避坑指南：我曾经在一个项目里混用了CMake和QMake——因为团队里有人习惯QMake，有人习惯CMake。结果呢？构建配置维护了两份，每次改个源文件路径都得同步修改。嗯，血的教训。选一个工具，坚持用到底。

知识体系总览

最后，我用一张图来总结本章的核心内容。这张图展示了跨平台编译的完整知识体系，从「为什么需要」到「用什么工具」，再到「怎么用」。

这张图把本章的核心内容串起来了。从上到下，先搞清楚「为什么」，再理解「是什么」，最后选择「用什么」。后面的章节，我们会深入每个工具链的具体用法，以及如何在Qt项目中实战跨平台编译。

本章小结：跨平台编译不是魔法，而是一套方法论。选对工具链，做好平台判断，你的代码就能在Windows、Linux、macOS上自由奔跑。记住：工具是死的，思路是活的。下一章，我们开始动手实战——用CMake搭建一个真正的跨平台Qt项目。

可可精品资料库

📚 课程目录

一、跨平台编译概述

什么是跨平台编译

为什么需要跨平台

主流跨平台工具链介绍

CMake

QMake

Meson

工具链对比

我的选择建议

知识体系总览