2. 开发环境搭建与工具链配置：Linux/Windows双平台开发环境搭建、交叉编译工具链安装与验证、SDK获取与版本管理（Git）

好，咱们正式开始动手了。这一章，说白了就是给你搭个“灶台”。锅碗瓢盆都摆好，后面炒菜才不慌。我见过太多新手，一上来就急着写代码，结果环境没配好，编译报错能卡一整天。嗯，咱们别走那个弯路。

2.1 双平台开发环境搭建：Linux 与 Windows 的选择

做嵌入式开发，尤其是涉及到 WiFi 和蓝牙协议栈这种底层的东西，我个人强烈建议你拥抱 Linux。为什么？因为绝大多数芯片厂商的 SDK、交叉编译工具链，原生支持的就是 Linux。Windows 当然也能做，但你会遇到各种“水土不服”的问题。

我自己平时的工作流是这样的：Windows 做文档、看代码、日常办公；Linux（虚拟机或双系统）做编译、调试、烧录。你想想看，这样分工最合理。

2.1.1 在 Windows 上搭建 Linux 开发环境

如果你只有 Windows 电脑，别担心。我推荐你用 WSL2（Windows Subsystem for Linux 2）。这玩意儿比虚拟机轻量太多了，而且和 Windows 文件系统互通。

安装步骤很简单，我帮你梳理一下：

1. 启用 WSL 功能：以管理员身份打开 PowerShell，运行 dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
2. 启用虚拟机平台：接着运行 dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart，然后重启电脑。
3. 安装 Linux 发行版：去 Microsoft Store 搜索 “Ubuntu”，我建议装 Ubuntu 20.04 LTS 或 22.04 LTS。这两个版本我实测过，对乐鑫、瑞昱、赛普拉斯等主流芯片的 SDK 兼容性最好。
4. 设置 WSL2 为默认版本：重启后，打开 PowerShell，运行 wsl --set-default-version 2。

2.1.2 原生 Linux 环境（推荐）

如果你有条件，直接装一个 Ubuntu 20.04/22.04 桌面版 做双系统，或者用一台旧电脑专门跑 Linux。这是最省心的方案。为什么？因为 USB 设备透传、串口识别、网络配置这些，在原生 Linux 下几乎零坑。

我个人习惯用 Ubuntu 22.04。它的内核版本比较新，对 WiFi 模组和蓝牙 dongle 的驱动支持更好。你想想看，如果你连 USB 转串口都识别不了，那还怎么调试？

2.2 交叉编译工具链安装与验证

好，环境有了，接下来是重头戏——交叉编译工具链。这东西是干嘛的？说白了，就是让你的 PC（x86 架构）能编译出给 ARM、RISC-V 等嵌入式芯片运行的代码。

不同的芯片厂商，工具链不一样。我以最常见的 ARM Cortex-M 系列 和 乐鑫 ESP32（Xtensa 架构） 为例。

2.2.1 ARM GCC 工具链安装

对于 ARM 内核的芯片（比如 NXP、ST、Nordic 的很多芯片），我们通常用 arm-none-eabi-gcc。

安装命令很简单：

# 更新包列表
sudo apt update

# 安装 ARM 交叉编译工具链
sudo apt install gcc-arm-none-eabi

# 验证安装
arm-none-eabi-gcc --version

如果看到版本号输出，比如 arm-none-eabi-gcc (15:9-2019-q4-0ubuntu1) 9.2.1 20191025，那就说明装好了。

2.2.2 乐鑫 ESP32 工具链安装

ESP32 用的是 Xtensa 架构，工具链需要从乐鑫官网下载。不过现在官方推荐直接用 ESP-IDF 框架，它会自动帮你搞定工具链。

我建议你这样做：

# 安装依赖
sudo apt install git wget flex bison gperf python3 python3-pip python3-venv cmake ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0

# 克隆 ESP-IDF
mkdir -p ~/esp
cd ~/esp
git clone --recursive https://github.com/espressif/esp-idf.git

# 安装工具链
cd ~/esp/esp-idf
./install.sh esp32

# 设置环境变量
. ./export.sh

安装完成后，运行 idf.py --version 验证。如果看到类似 v5.1.2 的版本号，就说明环境配好了。

2.2.3 验证工具链：写一个 Hello World

光装好不行，得验证它真的能用。我习惯写一个最简单的 C 程序来测试。

// test.c
#include <stdio.h>

int main() {
    printf("Hello, WiFi/BT Protocol Stack!\n");
    return 0;
}

然后用交叉编译器编译：

arm-none-eabi-gcc -c test.c -o test.o
arm-none-eabi-objdump -d test.o

如果能看到反汇编出来的 ARM 指令（比如 push {r7, lr}），那就说明工具链工作正常。嗯，这一步虽然简单，但能帮你排除 90% 的环境问题。

2.3 SDK 获取与版本管理（Git）

环境搭好了，工具链也验证了，接下来就是拿到芯片厂商的 SDK。这里我要重点说一下 版本管理。你想想看，一个项目做半年，SDK 可能更新好几个版本。如果没有 Git，你根本不知道改了哪里，出了问题也回退不了。

2.3.1 获取 SDK

不同的芯片厂商，获取方式不一样。我列几个常见的：

芯片厂商	SDK 名称	获取方式
乐鑫 (Espressif)	ESP-IDF	GitHub 克隆：git clone --recursive https://github.com/espressif/esp-idf.git
Nordic	nRF5 SDK / nRF Connect SDK	官网下载压缩包，或通过 nRF Connect 桌面版管理
瑞昱 (Realtek)	Ameba SDK	GitHub 或官方 FTP 下载
赛普拉斯 (Cypress/Infineon)	ModusToolbox	通过 ModusToolbox 的 Project Creator 自动拉取

2.3.2 Git 版本管理实战

我个人习惯这样管理 SDK：

1. 保持 SDK 原始分支不变：把厂商的 SDK 作为一个 upstream 远程仓库。
2. 创建自己的开发分支：基于某个稳定版本（比如 v4.4.3）创建 my_project_v1.0 分支。
3. 使用子模块管理：如果 SDK 依赖多个组件（比如蓝牙协议栈、WiFi 驱动），用 git submodule 来管理。

举个例子：

# 克隆 ESP-IDF
git clone https://github.com/espressif/esp-idf.git
cd esp-idf

# 查看所有标签（版本）
git tag -l

# 基于 v4.4.3 创建自己的分支
git checkout -b my_smart_speaker_v1 v4.4.3

# 添加自己的应用代码
mkdir -p examples/my_app
# ... 在这里写你的代码 ...

# 提交修改
git add .
git commit -m "feat: add smart speaker application based on ESP-IDF v4.4.3"

2.3.3 管理多个 SDK 版本

有时候，你可能需要同时维护多个项目，每个项目依赖不同版本的 SDK。这时候，我建议你用 Git 工作树（worktree） 或者 环境变量 来隔离。

比如，我电脑上有两个项目：

• 项目 A：基于 ESP-IDF v4.4.3
• 项目 B：基于 ESP-IDF v5.1.2

我会在 ~/.bashrc 里设置别名：

alias idf4='export IDF_PATH=~/esp/esp-idf-v4.4.3 && . $IDF_PATH/export.sh'
alias idf5='export IDF_PATH=~/esp/esp-idf-v5.1.2 && . $IDF_PATH/export.sh'

这样，我只需要在终端输入 idf4 或 idf5，就能快速切换环境。嗯，这个小技巧帮我省了不少时间。

2.4 本章小结

这一章的内容，说白了就是“磨刀不误砍柴工”。我们把 Linux 环境搭好了，交叉编译工具链装上了，SDK 也通过 Git 管理起来了。后面的章节，我们就可以真正开始研究 WiFi 和蓝牙协议栈的移植了。

记住一句话：环境问题，永远是嵌入式开发里最磨人、也最不值得花时间的问题。一次性把它配好、配稳，后面你会感谢自己的。