3. 开发环境搭建：Python环境、pymavlink库安装、串口与UDP模拟器配置
说实话，很多初学者一上来就拿着飞控板接线，结果不是驱动装不上，就是串口被占用，折腾半天连个心跳包都收不到。我个人的习惯是——先把地面端的开发环境搭利索了，再碰硬件。这样出了问题，你能明确知道是代码的问题，还是硬件的问题。
这一章我们就来搞定三件事：Python环境、pymavlink库、以及最重要的——串口与UDP模拟器。有了模拟器，你甚至不需要一块真实的飞控板，就能跑通整个MAVLink通信链路。
3.1 Python环境准备
MAVLink的生态里，Python是当之无愧的一等公民。无论是解析协议、写地面站脚本，还是做日志分析，Python都能搞定。
3.1.1 版本选择
我建议你直接用 Python 3.8 到 3.11 之间的版本。为什么？因为pymavlink对Python 3.12的支持目前还有些小坑，我在项目里遇到过依赖编译不过的情况。稳妥起见，选3.10最省心。
| Python版本 | pymavlink兼容性 | 我的建议 |
|---|---|---|
| 3.7及以下 | 部分旧版可用 | 不推荐，已停止安全更新 |
| 3.8 - 3.11 | 完全兼容 | 推荐使用 |
| 3.12 | 部分扩展包需手动编译 | 新手慎用 |
3.1.2 虚拟环境
这一点我吃过亏。以前做项目时，同时维护三四个脚本，有的依赖pymavlink 2.4，有的依赖2.6，结果全局装来装去，把系统Python搞崩了。后来我养成了一个习惯：每个项目建一个虚拟环境。
mav_env，清晰明了。
# 创建虚拟环境
python -m venv mav_env
# 激活环境（Windows）
mav_env\Scripts\activate
# 激活环境（macOS/Linux）
source mav_env/bin/activate激活后，你会看到命令行前面多了个 (mav_env) 前缀。嗯，看到这个前缀，就说明你已经在隔离环境里了，随便装，不会污染系统。
3.2 pymavlink库安装
pymavlink是MAVLink协议最成熟的Python实现。它不仅能解析消息，还能生成代码、读写日志，甚至直接操作串口和UDP。
3.2.1 安装命令
激活虚拟环境后，一行命令搞定：
pip install pymavlink如果你在国内，网络不太稳定，可以加个镜像源：
pip install pymavlink -i https://pypi.tuna.tsinghua.edu.cn/simple3.2.2 验证安装
装完之后，怎么知道装没装对？进Python交互环境，敲两行代码：
python
>>> from pymavlink import mavutil
>>> print(mavutil.__version__)如果输出了版本号，比如 2.4.32，那就成了。如果报错 ModuleNotFoundError，别慌，检查一下你是不是在虚拟环境里运行的Python。
where python（Windows）或 which python（Linux/macOS）确认一下路径对不对。
3.3 串口与UDP模拟器配置
这是本章的重头戏。你想想看，如果没有真实的飞控硬件，怎么调试MAVLink通信？答案是——用模拟器。模拟器可以虚拟出一个飞控，通过串口或UDP跟你写的脚本通信。
3.3.1 为什么需要模拟器？
我在带团队时，一直强调一个原则：先仿真，后实飞。原因有三：
- 安全：代码写错了，模拟器里炸就炸了，实飞炸了就是钱。
- 效率：模拟器可以随时暂停、重置、注入故障，实飞做不到。
- 可重复：同样的场景，模拟器可以跑一百遍，实飞受天气、电池影响很大。
3.3.2 串口模拟器（Windows用com0com，Linux用socat）
串口模拟器的核心思想是：创建一对虚拟串口，一个给飞控（或模拟飞控的程序），一个给你的地面站脚本。数据从一端写入，从另一端读出，就像真的串口一样。
Windows下的配置（com0com）
我个人在Windows上调试时，常用com0com。安装后，打开它的配置界面，添加一对串口，比如COM3和COM4。然后：
- 你的模拟飞控程序监听COM3
- 你的地面站脚本连接COM4
两边就能通信了。
Linux/macOS下的配置（socat）
Linux下更简单，一条命令：
socat -d -d pty,raw,echo=0 pty,raw,echo=0执行后，会输出两个设备路径，比如 /dev/pts/2 和 /dev/pts/3。这两个就是一对虚拟串口。
3.3.3 UDP模拟器
串口模拟器适合调试底层驱动，但如果你只是想验证MAVLink协议解析逻辑，UDP模拟器更方便。为什么？因为UDP不需要物理串口，同一台机器上，两个程序通过IP和端口就能通信。
我常用的UDP模拟器配置是这样的：
| 角色 | IP地址 | 端口 |
|---|---|---|
| 模拟飞控（发送端） | 127.0.0.1 | 14550 |
| 地面站脚本（接收端） | 127.0.0.1 | 14551 |
这里有个关键点：MAVLink的UDP通信通常是单向的。飞控往地面站发数据，地面站监听即可。如果地面站需要发指令给飞控，那就再开一个反向端口。
3.3.4 用Python快速验证模拟器
模拟器配好了，怎么知道通不通？写个简单的Python脚本测一下。
模拟飞控端（发送心跳包）
# fake_fc.py
from pymavlink import mavutil
import time
# 创建一个UDP连接，模拟飞控向14550端口发送数据
master = mavutil.mavlink_connection('udpout:127.0.0.1:14550')
while True:
# 发送心跳包
master.mav.heartbeat_send(
mavutil.mavlink.MAV_TYPE_QUADROTOR,
mavutil.mavlink.MAV_AUTOPILOT_ARDUPILOTMEGA,
0, 0, 0
)
print("发送心跳包")
time.sleep(1)地面站端（接收心跳包）
# gcs.py
from pymavlink import mavutil
# 监听本地14550端口
master = mavutil.mavlink_connection('udpin:0.0.0.0:14550')
while True:
msg = master.recv_match(type='HEARTBEAT', blocking=True)
if msg:
print(f"收到心跳包，系统类型: {msg.type}")先运行 gcs.py，再运行 fake_fc.py。如果控制台每秒打印一次"收到心跳包"，说明模拟器配置成功，MAVLink通信链路已经打通。
udpin: 换成 serial: 即可。比如 mavutil.mavlink_connection('serial:COM4')。pymavlink会自动处理串口参数。
3.4 本章知识体系
为了让你更直观地理解整个开发环境的搭建逻辑，我画了一张流程图。它展示了从Python环境到模拟器，再到MAVLink通信的全链路关系。
从这张图可以看得很清楚：Python环境是地基，pymavlink是桥梁，模拟器是测试场。三者缺一不可。很多新手一上来就想连真飞控，结果串口线插反了、波特率配错了、驱动没装好，折腾半天连个HEARTBEAT都收不到。其实先用模拟器跑通流程，再换真硬件，效率会高很多。