01 · Fedora 开发环境
目标：准备编译 Zephyr 固件所需的主机工具。本页是给后续实验使用的操作说明；当前搭建文档站并未替你安装这些系统包。
先保持目录清晰
~/Projects/
├── zephyr-docs/ # 当前中文文档站
└── zephyr-workspace/ # 后续实际执行 west init 时创建
├── .venv/ # Python 虚拟环境
├── .west/ # west 元数据
├── zephyr/ # Zephyr 源码
├── modules/ # west 管理的依赖
└── applications/ # 自己的固件应用
SDK 后续放在 ~/.local/opt/；不要把大型源码树、SDK、串口日志或虚拟环境塞进文档仓库。
安装工具
Zephyr v4.2.0 官方 Fedora 指南列出以下依赖：
sudo dnf group install "Development Tools" "C Development Tools and Libraries"
sudo dnf install cmake ninja-build gperf dfu-util dtc wget which \
python3-pip python3-tkinter xz file python3-devel SDL2-devel
不同 Fedora 发行版的软件组名称可能变化。若提示软件组不存在，先用 dnf group list 查看可用组；基础命令缺失时，可以按包名补充 git gcc gcc-c++ make。把实际 Fedora 版本和安装差异记入实验记录，不要忽略报错继续操作。
验证版本
cat /etc/fedora-release
uname -m
git --version
cmake --version
python3 --version
dtc --version
ninja --version
v4.2.0 入门指南的最低要求：CMake 3.20.5、Python 3.10、DTC 1.4.6。更高 Python 版本仍可能遇到第三方包兼容问题；出现失败先保留日志，再根据该版本 requirements 排查。
检查点
- 记录 Fedora 版本和主机架构。
-
git、cmake、python3、dtc、ninja都能正常输出版本。 - 明确文档目录和固件工作区是两个目录。
下一步：创建 west 工作区。
官方来源
基于 Zephyr v4.2.0 官方资料整理的中文学习笔记，非逐字翻译；命令及说明作了学习场景适配。