1. 课程导学与环境总览
大家好，欢迎来到《跨平台编译环境搭建实战》。我是你们这门课的老朋友，一个在编译工具链里摸爬滚打多年的工程师。今天咱们先不急着敲代码，坐下来聊聊——到底什么是跨平台编译？我们为什么需要它？
什么是跨平台编译？
说白了，跨平台编译就是在一台电脑上写代码，然后生成能在另一种完全不同的电脑上运行的程序。举个例子，你在Windows笔记本上写C++代码，编译出来的可执行文件，却能在Linux服务器或者ARM架构的树莓派上跑起来。
嗯，这里要注意，它和「交叉编译」不完全是一回事。交叉编译通常指目标平台和宿主平台架构不同（比如x86编译ARM），而跨平台编译的范围更广——它还包括操作系统、库依赖、ABI接口的差异。我个人习惯把跨平台编译理解为：一次编写，到处编译。
核心概念：跨平台编译 = 同一份源码 + 不同工具链 + 不同平台配置 → 生成多个平台的原生可执行文件。
我在项目中遇到过最典型的场景：团队用macOS开发，但客户要求提供Windows和Linux的安装包。如果没有跨平台编译，你就得在每台机器上分别搭建环境、分别编译、分别调试——想想就头大。
为什么需要它？
你想想看，现在做软件开发，谁还敢只盯着一个平台？
- 桌面端：Windows、macOS、Linux，三足鼎立
- 移动端：Android（ARM64）、iOS（ARM64），各有各的规矩
- 嵌入式/IoT：ARM Cortex-M、RISC-V、MIPS，百花齐放
- 云端：x86_64、ARM Graviton，甚至还有AMD的EPYC
我曾经接手过一个项目，代码在x86上跑得飞快，但客户要求部署到ARM服务器上。结果发现依赖的第三方库只提供了x86的预编译包，整个团队加班两周才搞定移植。从那以后，我养成了一个习惯：项目启动第一天，就把跨平台编译方案定下来。
避坑指南：我曾经因为没提前规划跨平台，导致项目后期需要重写Makefile。那滋味，真不好受。所以这门课的第一个目标就是——让你从一开始就走在正确的路上。
课程目标与学习路径
这门课不是讲理论，而是实打实的动手课。学完之后，你应该能做到：
- 独立搭建一套跨平台编译环境，支持至少3个目标平台
- 熟练使用CMake、Meson、Bazel这三种主流工具
- 解决实际问题：比如依赖管理、工具链配置、缓存加速
- 理解底层原理：为什么这样配？不这样配会出什么问题？
学习路径我建议这样走：先学CMake（最通用），再学Meson（更现代），最后挑战Bazel（Google出品，适合大型项目）。每章我都会给出真实项目中的配置示例，你跟着敲一遍，比看十遍书都管用。
主流跨平台工具概览
现在市面上主流的跨平台构建工具有三个：CMake、Meson、Bazel。我简单说说它们的特点，后面几章会深入讲解。
| 工具 | 语言 | 配置文件 | 主要特点 | 适合场景 |
|---|---|---|---|---|
| CMake | CMakeLists.txt | CMake语言 | 生态最成熟，支持几乎所有平台和IDE | 通用项目、C/C++、大型库 |
| Meson | meson.build | Python风格 | 速度快、语法简洁、内置Ninja后端 | 新项目、追求编译速度 |
| Bazel | BUILD / WORKSPACE | Starlark（Python子集） | 增量编译极快、多语言支持、Google内部验证 | 大型项目、微服务、多语言混合 |
我个人习惯是：小项目用CMake，中型项目用Meson，大型项目或团队协作用Bazel。当然这不是绝对的，你完全可以根据团队技术栈来选择。
注意：不要盲目追求「最新最热」的工具。我见过有人用Bazel搭了一个只有两个源文件的项目，结果光配置就写了三天。工具是为人服务的，别搞反了。
本章知识体系
为了让你更直观地理解本章的内容结构，我画了一张图。它展示了跨平台编译的核心逻辑，以及我们这门课要覆盖的三大工具。
这张图其实就概括了我们这门课的核心脉络。从中心出发，三个分支分别对应三种工具。你不需要一开始就全部掌握，跟着课程节奏，一个一个来就好。
写在最后
嗯，第一章的内容就到这里。跨平台编译听起来高大上，但说白了就是一套方法论加工具链的组合。我见过太多人在这上面栽跟头——不是配置写错了，就是依赖没处理好。这门课的目的，就是帮你把这些坑都填平。
记住一句话：跨平台编译不是魔法，而是工程。只要方法对，你也能轻松驾驭。
课后小任务：打开终端，分别执行 cmake --version、meson --version、bazel version，看看你的机器上已经安装了哪些工具。下一章我们会从CMake开始，手把手搭建第一个跨平台项目。