2. 开发环境概览：Zephyr 开发所需工具链
搭建 Zephyr OS 驱动开发环境，本质上是组合一套跨平台、可复用的嵌入式构建流水线。本章将系统梳理核心工具链、主机系统要求以及环境变量规划，帮助你在开始安装前建立全局认知。
学习目标：理解 West、CMake、Ninja 与编译器的角色分工；明确 Linux / Windows / macOS 三平台的差异点；掌握环境变量与路径规划的最佳实践。
2.1 核心工具链全景
Zephyr 的构建系统采用分层设计，每一层工具负责一个独立环节。下图展示了从源码到可执行文件的完整工具链协作流程：
2.2 工具链角色与选型
| 工具 | 版本要求 | 核心职责 | 典型命令 |
|---|---|---|---|
| West | ≥ 1.2.0 | 多仓库管理、项目初始化、命令调度 | west init / west build |
| CMake | ≥ 3.20.0 | 生成构建系统文件（Makefile / Ninja） | cmake -B build |
| Ninja | ≥ 1.10.0 | 高性能并行构建执行器 | ninja |
| 编译器 | ARM GCC / LLVM / Zephyr SDK | 交叉编译目标架构代码 | arm-none-eabi-gcc |
关键选择：Zephyr 官方推荐使用 Zephyr SDK，它预打包了交叉编译器、调试器（GDB）、QEMU 模拟器以及必要的库文件，可避免手动配置工具链的兼容性问题。
2.3 主机系统要求
Zephyr 支持三大主流桌面操作系统，但各平台的安装方式与注意事项有所不同：
- Linux（Ubuntu 22.04 / Fedora 38+）：原生支持最佳，包管理器可直接安装依赖；推荐作为首选开发平台。
- Windows（10 / 11）：需启用 Windows Subsystem for Linux (WSL2)，在 Ubuntu 环境下运行；原生 PowerShell 支持有限。
- macOS（Ventura / Sonoma）：需安装 Homebrew 补充依赖；Apple Silicon (M1/M2) 需注意 Rosetta 2 兼容性。
2.4 环境变量与路径规划
Zephyr 构建系统依赖一组环境变量来定位工具链、SDK 和项目根目录。合理的路径规划可以避免后续版本升级时的混乱。
核心环境变量
| 变量名 | 作用 | 典型值示例 |
|---|---|---|
ZEPHYR_BASE |
Zephyr 仓库根目录 | /home/user/zephyrproject/zephyr |
ZEPHYR_SDK_INSTALL_DIR |
Zephyr SDK 安装路径 | /opt/zephyr-sdk-0.16.8 |
ZEPHYR_TOOLCHAIN_VARIANT |
指定编译器类型 | zephyr 或 gnuarmemb |
PATH |
添加 West / CMake / Ninja 可执行路径 | /home/user/.local/bin |
推荐目录结构
~/zephyrproject/ # 工作区根目录
├── zephyr/ # Zephyr 内核源码 (ZEPHYR_BASE)
├── modules/ # 外部模块 (hal, lib, crypto 等)
├── tools/ # 辅助工具
├── app/ # 用户应用目录
│ ├── src/
│ ├── CMakeLists.txt
│ └── prj.conf
└── .west/ # West 配置文件 (自动生成)
避坑提示：不要将 Zephyr SDK 安装在包含空格或中文的路径下；不要将
ZEPHYR_BASE 指向符号链接，应使用真实路径。每次打开新终端时，建议在项目根目录执行 source zephyr/zephyr-env.sh 以自动加载环境变量。
2.5 环境变量加载流程
下图展示了从终端启动到构建执行的环境变量传递路径：
2.6 快速验证清单
在进入下一章安装环节前，建议对照以下清单确认你的主机环境准备情况：
- ✅ 操作系统版本满足最低要求（Linux 内核 ≥ 5.10 / Windows 10 22H2 / macOS 13+）
- ✅ 磁盘剩余空间 ≥ 10 GB（Zephyr SDK + 源码 + 编译中间文件）
- ✅ 网络可正常访问 GitHub / 国内镜像源
- ✅ Python 3.8+ 已安装（West 依赖 Python）
- ✅ Git 2.30+ 已安装并配置好用户名与邮箱
小贴士：如果你使用的是 Windows，强烈建议提前安装 Windows Terminal 和 WSL2，并配置 Ubuntu 22.04 发行版。后续所有操作都将在 WSL2 终端中完成，体验与原生 Linux 几乎一致。