宿主机准备：三大平台的开发环境初始化

说实话，跨平台开发最头疼的往往不是代码怎么写，而是环境怎么搭。我见过太多团队，代码写得挺好，结果换台机器就编译不过——十有八九是环境没统一。这一章，我就带你走一遍 Windows、Linux、macOS 三大平台的环境初始化流程。

2.1 为什么环境初始化这么重要？

你想想看，一个项目要同时在三个系统上编译。Windows 用 MSVC，Linux 用 GCC，macOS 用 Clang。光编译器就三个，再加上 CMake、Ninja、Python 这些辅助工具。如果不提前规划好，后面全是坑。

我记得有一次，团队新来的同事在 Windows 上装了 MinGW，结果链接时死活找不到标准库。折腾了两天，最后发现是路径里混了空格。嗯，这种问题其实完全可以避免。

2.2 Windows 环境搭建

Windows 上我建议用 Visual Studio 2022 作为主力编译器。别用太老的版本，C++17/20 的支持度差很多。

2.2.1 安装 Visual Studio

1. 去官网下载 Visual Studio 2022 Community 版（免费）
2. 安装时勾选「使用 C++ 的桌面开发」工作负载
3. 单个组件里，确保选中 Windows 10 SDK 和 C++ CMake 工具
4. 安装路径不要有中文，不要有空格

2.2.2 安装 CMake 与 Ninja

CMake 是跨平台构建的基石。Ninja 比 MSBuild 快得多，我强烈推荐。

# 下载 CMake 安装包（选 Windows x64 Installer）
https://cmake.org/download/

# 安装时勾选 "Add CMake to system PATH"
# Ninja 直接下载 exe 放到 C:\tools\ninja.exe
# 然后把 C:\tools 加到 PATH 里

2.2.3 验证环境

# 打开 PowerShell 或 CMD
cmake --version
ninja --version
cl.exe

# 能看到版本号，说明环境通了

2.3 Linux 环境搭建

Linux 相对简单，但发行版不同，包管理器也不同。我以 Ubuntu 22.04 LTS 为例，其他发行版类似。

2.3.1 安装 GCC 与 Clang

# 更新包索引
sudo apt update

# 安装 GCC 12
sudo apt install gcc-12 g++-12

# 安装 Clang 14
sudo apt install clang-14 lld-14

# 设置默认版本（可选）
sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-12 100
sudo update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-12 100

2.3.2 安装 CMake 与 Ninja

# 直接 apt 安装
sudo apt install cmake ninja-build

# 验证
cmake --version
ninja --version

2.3.3 配置多版本切换

实际项目中，你可能需要同时测试 GCC 和 Clang。我建议用 update-alternatives 管理。

# 查看当前默认
gcc --version

# 临时切换（只对当前终端有效）
export CC=clang-14
export CXX=clang++-14

# 永久切换
sudo update-alternatives --config gcc

2.4 macOS 环境搭建

macOS 上我推荐用 Homebrew 管理工具链。别用系统自带的 Clang，版本太旧。

2.4.1 安装 Xcode Command Line Tools

# 先装命令行工具
xcode-select --install

# 这会安装 Apple Clang、ld、make 等基础工具
# 但注意：Apple Clang 和标准 Clang 有差异

2.4.2 安装 Homebrew 与 LLVM

# 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 LLVM（包含 Clang、lld、libc++）
brew install llvm

# 安装 CMake 和 Ninja
brew install cmake ninja

2.4.3 配置 PATH 优先级

Homebrew 安装的 LLVM 默认在 /usr/local/opt/llvm/bin。你需要让系统优先使用它，而不是 Xcode 自带的。

# 编辑 ~/.zshrc 或 ~/.bash_profile
export PATH="/usr/local/opt/llvm/bin:$PATH"
export LDFLAGS="-L/usr/local/opt/llvm/lib"
export CPPFLAGS="-I/usr/local/opt/llvm/include"

# 生效
source ~/.zshrc

2.5 跨平台工具链统一

环境搭好了，但三个平台的编译器版本、路径、行为都不一样。怎么保证编译结果一致？

我的做法是：用 CMake 的 toolchain 文件统一管理。

2.5.1 编写统一的 CMakeLists.txt

cmake_minimum_required(VERSION 3.20)
project(CrossPlatformDemo LANGUAGES CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

# 检测平台
if(WIN32)
    message(STATUS "Building on Windows")
elseif(APPLE)
    message(STATUS "Building on macOS")
elseif(UNIX)
    message(STATUS "Building on Linux")
endif()

add_executable(demo main.cpp)

2.5.2 使用预设的构建脚本

我习惯在每个项目根目录放一个 build.sh（或 build.bat），统一构建流程。

#!/bin/bash
# build.sh - 跨平台构建脚本

BUILD_DIR="build"
mkdir -p $BUILD_DIR
cd $BUILD_DIR

cmake .. -G Ninja -DCMAKE_BUILD_TYPE=Release
ninja -j$(nproc)

2.6 环境验证清单

环境搭完，别急着写代码。先跑一遍验证清单，确保所有工具都正常。

# 一行命令检查所有
gcc --version && cmake --version && ninja --version && python3 --version && git --version

2.7 本章知识体系

下面这张图，概括了三大平台环境初始化的核心逻辑。你可以把它当作一个检查清单。

这张图你看懂了吗？从上到下，先分别搭建三个平台的工具链，然后用 CMake 统一构建，最后输出一个可跨平台编译的环境。说白了，就是「分而治之，统一管理」。