2. Zephyr网络栈基础
说实话，很多初学者在Zephyr网络开发上栽跟头，不是代码写错了，而是环境没搭对。我见过太多人花了一周时间折腾编译错误，最后发现是SDK版本不匹配。这一节，咱们就把地基打牢。
2.1 Zephyr SDK安装——别小看这一步
Zephyr SDK不是普通的交叉编译工具链。它包含了针对多种架构的编译器、调试器、QEMU模拟器，以及Zephyr自己封装的host工具。我个人习惯把SDK放在 /opt 目录下，这样多项目共享方便。
安装步骤（以Linux x86_64为例）
- 下载SDK安装包：
wget https://github.com/zephyrproject-rtos/sdk-ng/releases/download/v0.16.8/zephyr-sdk-0.16.8_linux-x86_64.tar.xz - 解压到目标目录：
sudo tar xvf zephyr-sdk-0.16.8_linux-x86_64.tar.xz -C /opt - 运行安装脚本：
cd /opt/zephyr-sdk-0.16.8 && sudo ./setup.sh - 配置udev规则（用于调试器权限）：
sudo cp /opt/zephyr-sdk-0.16.8/sysroots/x86_64-pokysdk-linux/usr/share/openocd/contrib/60-openocd.rules /etc/udev/rules.d/ - 重新加载udev：
sudo udevadm control --reload
setup.sh，结果编译时提示找不到 zephyr-elf-gcc。这个脚本会创建符号链接并配置环境变量，千万别跳过。
2.2 West工具——Zephyr的瑞士军刀
West是Zephyr的元构建工具。它不只是个构建系统，还负责管理多个仓库、拉取依赖、执行构建和烧录。说白了，你以后跟Zephyr打交道，90%的时间都在用west命令。
安装West
pip3 install west嗯，就这么简单。但要注意，建议在Python虚拟环境中安装，避免污染系统Python。我一般这样操作：
python3 -m venv ~/zephyr-venv
source ~/zephyr-venv/bin/activate
pip3 install west初始化工作空间
west init ~/zephyr-project
cd ~/zephyr-project
west updatewest update 这一步会拉取Zephyr主仓库、模块仓库（比如网络协议栈相关的 net-tools、hal 等）。网络不好的话，你可能要等很久。我建议用代理或者提前准备好镜像源。
常用West命令速查表
| 命令 | 作用 | 我常用的场景 |
|---|---|---|
west build |
编译项目 | 指定板子和配置，比如 west build -b qemu_x86 -t run |
west flash |
烧录固件 | 配合调试器直接烧到开发板 |
west debug |
启动调试会话 | 用GDB远程调试网络协议栈 |
west list |
查看已安装模块 | 确认网络相关模块是否拉取完整 |
west config |
查看/修改配置 | 设置 build.dir-fmt 自定义构建输出路径 |
2.3 Kconfig网络配置详解——这里最容易出错
Kconfig是Zephyr的配置系统。你想想看，一个TCP/IP协议栈要支持IPv4、IPv6、DHCP、DNS、TLS……如果全部编译进去，固件体积会爆炸。Kconfig就是让你按需裁剪的。
我个人习惯把网络相关的Kconfig配置分成三层：
- 基础层： 使能网络协议栈本身
- 协议层： 选择IPv4/IPv6、TCP/UDP等
- 功能层： 调试日志、统计信息、性能监控
核心网络Kconfig选项
# 使能网络协议栈
CONFIG_NETWORKING=y
# 使能网络设备驱动
CONFIG_NET_DRIVERS=y
# 选择IP协议版本
CONFIG_NET_IPV4=y
CONFIG_NET_IPV6=n # 如果只用IPv4，关掉IPv6节省内存
# 使能TCP协议
CONFIG_NET_TCP=y
# 设置TCP接收/发送缓冲区大小（字节）
CONFIG_NET_TCP_RCV_WND_SIZE=65536
CONFIG_NET_TCP_SND_WND_SIZE=65536
# 使能网络调试日志
CONFIG_NET_LOG=y
CONFIG_NET_STATISTICS=yCONFIG_NET_STATISTICS 和 CONFIG_NET_LOG 打开。等调优完成，再关掉它们以释放内存和CPU开销。你想想看，生产环境里这些日志每秒可能产生几千条，对性能影响不小。
使用menuconfig图形化配置
如果你觉得手写Kconfig文件太麻烦，可以用menuconfig：
west build -b qemu_x86 -t menuconfig这会弹出一个终端图形界面，你可以用方向键浏览和修改配置。我个人习惯先用menuconfig快速定位选项，然后把最终配置固化到 prj.conf 文件中。
2.4 网络配置的避坑指南
我在项目中遇到过几次网络配置导致的诡异问题，分享出来给大家参考：
- 缓冲区太小导致丢包： 默认的TCP窗口只有4KB，在高速网络下根本不够用。我建议至少设到16KB以上。
- IPv6默认使能： 很多开发板默认同时开启IPv4和IPv6。如果你的网络环境只用IPv4，记得关掉IPv6，能省下不少内存。
- 调试日志影响时序： 打开
CONFIG_NET_LOG后，网络中断处理函数里如果打印日志，会严重影响吞吐量。我曾经排查一个性能问题，最后发现是日志打印占了50%的CPU时间。
2.5 本章知识体系总览
下面这张图总结了开发环境搭建与配置的核心流程。你可以把它当作一个检查清单：
2.6 快速验证：跑一个网络示例
环境搭好之后，我建议立刻跑一个网络示例验证。用Zephyr自带的 echo_server 示例：
cd ~/zephyr-project
west build -b qemu_x86 samples/net/sockets/echo_server
west build -t run如果看到终端输出 Waiting for connection...，说明环境搭建成功。这时候你可以用 net-tools 里的 echo-client 测试通信：
cd ~/zephyr-project/tools/net-tools
./echo-client -i eth0 192.0.2.1