Windows 原生开发环境

本页依据文档基线与后续更新中记录的 Zephyr main 快照更新。

当前官方入门流程使用 Windows 的 winget 安装主机工具，并在 Python 虚拟环境内安装 west。Zephyr SDK 支持 Windows；无需沿用旧教程中的独立 GNU Arm Embedded 工具链、 MSYS2 混合环境或 2021 年 QEMU 安装包。

主机工具

在 Windows 10 或更新系统的 PowerShell 或 cmd.exe 中运行：

winget install Kitware.CMake Ninja-build.Ninja oss-winget.gperf Python.Python.3.12 Git.Git oss-winget.dtc wget 7zip.7zip

安装完成后重新打开终端，确认：

py -3.12 --version
cmake --version
git --version
ninja --version
dtc --version

Python 至少为 3.12，CMake 至少为 3.20.5，dtc 至少为 1.4.6。必要时将 7-Zip 安装目录加入 PATH。若不能使用 winget，可从各工具官网安装，并确认命令来自同一套原生 Windows 工具环境。

PowerShell 工作区

以下命令在普通用户 PowerShell 中执行，使用用户目录下的新工作区：

cd $Env:USERPROFILE
py -3.12 -m venv zephyrproject\.venv
.\zephyrproject\.venv\Scripts\Activate.ps1
python -m pip install west
west init -m https://github.com/zephyrproject-rtos/zephyr --mr main zephyrproject
cd zephyrproject
west update
python -m pip install @((west packages pip) -split ' ')
west zephyr-export
cd zephyr
west sdk install

若 PowerShell 阻止运行激活脚本，可按所在环境的脚本策略处理，或使用下文的 cmd.exe 激活方式。执行策略由管理员管理的设备应遵循本机策略。 main 是浮动开发分支，固定版本的方法见搭建开发环境并运行第一个应用。

cmd.exe 的差异

在 cmd.exe 中创建并激活虚拟环境：

cd /d %USERPROFILE%
py -3.12 -m venv zephyrproject\.venv
zephyrproject\.venv\Scripts\activate.bat

执行相同的 west 初始化与更新后，在工作区顶层安装依赖：

cmd /c zephyr\scripts\utils\west-packages-pip-install.cmd
west zephyr-export
cd zephyr
west sdk install

PowerShell 的 @(...) 参数展开语法不能直接粘贴到 cmd.exe。

构建与烧录

在工作区的 zephyr 目录构建 QEMU 示例：

west build -p always -b qemu_cortex_m3 samples/hello_world
west build -t run

使用真实硬件时根据官方板卡页面选择目标，例如：

west build -p always -b nrf52840dk/nrf52840 samples/basic/blinky
west flash

开发板烧录还可能需要驱动程序、runner 和厂商提供的调试工具。SDK 安装成功不能代替板卡侧的烧录配置。

下载与路径问题

旧网盘、旧镜像的内容无法保证与当前 west.yml 匹配。使用镜像时核对主仓库提交号，并确保清单中的所有所需模块修订版可获取。下载失败应先处理网络或代理配置，再重新执行 west update。

尽量使用较短且无空格的工作区路径。出现找不到 Python、CMake、编译器等问题时，先用 Get-Command python, west, cmake （PowerShell）或 where python （cmd）核对实际可执行文件，避免调用旧环境中的同名命令。

官方入门文档目前仍不推荐以 WSL 烧录作为初学者路径；容器和 WSL 的说明见 Windows、WSL 与容器开发。