3. 开发环境搭建：Python环境、pymavlink库安装、串口与UDP连接配置
好，咱们正式开始动手。这一章我带你把开发环境搭起来。别小看这一步，我在项目里见过太多人因为环境没配好，浪费一整天排查“代码没问题但就是连不上”的玄学问题。说白了，工欲善其事，必先利其器。
3.1 Python环境：选对版本，省一半心
我个人习惯用 Python 3.8 到 3.11 之间的版本。pymavlink 对 3.12 的支持还在磨合期，我建议你暂时别踩这个坑。
⚠ 避坑提醒： 我曾经在 Python 3.12 上装 pymavlink，编译 C 扩展时报了一堆错。折腾两小时后换回 3.10，五分钟搞定。你想想看，这时间花得值不值？
安装步骤很简单，三步走：
- 下载安装包：去 python.org 下载对应版本。Windows 用户记得勾选“Add Python to PATH”。
- 验证安装：打开终端，敲
python --version。如果显示你装的版本号，就成了。 - 创建虚拟环境（我强烈推荐）：
python -m venv mavlink_env # Windows 激活 mavlink_env\Scripts\activate # macOS/Linux 激活 source mavlink_env/bin/activate
💡 我的小习惯： 每个项目单独建虚拟环境。这样不同项目依赖互不干扰。你以后维护多个飞控项目时就知道这有多香了。
3.2 安装pymavlink：核心通信库
pymavlink 是咱们和飞控对话的桥梁。它负责把 MAVLink 协议包解析成 Python 能理解的对象。
安装命令就一行：
pip install pymavlink如果你在 Linux 或 macOS 上，可能需要先装一些系统依赖：
# Ubuntu/Debian
sudo apt-get install python3-dev libxml2-dev libxslt1-dev
# macOS
brew install libxml2 libxslt装完后验证一下：
python -c "from pymavlink import mavutil; print('pymavlink installed successfully')"看到成功提示，说明环境通了。
📌 注意： pymavlink 依赖 future、lxml 等库。如果安装报错，多半是网络问题或缺少编译工具。换国内镜像源试试：
pip install pymavlink -i https://pypi.tuna.tsinghua.edu.cn/simple
3.3 串口连接配置：和飞控“物理握手”
串口是最直接的连接方式。飞控通过 USB 转串口芯片（常见 CP2102、CH340、FTDI）和电脑通信。
配置串口连接，核心参数就这几个：
| 参数 | 说明 | 典型值 |
|---|---|---|
| 端口名 | 系统分配给串口设备的名称 | Windows: COM3 Linux: /dev/ttyUSB0 macOS: /dev/cu.usbserial-xxx |
| 波特率 | 通信速率，单位 bps | 115200（Pixhawk 默认） 57600（老版本） |
| 超时 | 等待数据的最长时间 | 3 秒 |
代码示例：
from pymavlink import mavutil
# 创建串口连接
master = mavutil.mavlink_connection(
device='/dev/ttyUSB0', # 根据你的系统改
baud=115200,
timeout=3
)
# 等待心跳包，确认连接成功
master.wait_heartbeat()
print("✅ 飞控已连接，系统ID:", master.target_system)
⚠ 常见问题： 我曾经遇到串口被其他程序占用的情况。比如 Mission Planner 或 QGroundControl 已经连上了飞控，你的 Python 脚本就抢不到端口。关掉地面站再试。
3.4 UDP连接配置：无线调试利器
串口有根线拖着，调试时不太方便。UDP 连接让你通过局域网无线收发 MAVLink 数据。飞控端通常通过 WiFi 数传模块或树莓派转发数据。
UDP 有两种模式：
- UDP 客户端：你的脚本主动连接飞控的 IP 和端口。
- UDP 服务器：你的脚本监听一个端口，等飞控发数据过来。
两种模式的代码：
from pymavlink import mavutil
# UDP 客户端模式（主动连接飞控）
master = mavutil.mavlink_connection(
'udp:192.168.1.100:14550', # 飞控IP和端口
source_system=1
)
# UDP 服务器模式（监听本地端口）
master = mavutil.mavlink_connection(
'udp:0.0.0.0:14550', # 监听所有网卡
input=True, # 声明为输入模式
source_system=1
)
💡 实战经验： 我在室内调试时喜欢用 UDP 服务器模式。飞控端通过 WiFi 数传不断发数据，我的笔记本只要连上同一个路由器就能收到。不用插线，满屋子跑着测姿态都没问题。
3.5 连接方式对比：什么时候用哪个？
| 连接方式 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| 串口 | 稳定、延迟低、不受网络影响 | 有物理线缆、距离受限 | 首次调试、参数写入、固件刷写 |
| UDP | 无线、灵活、可多机同时监听 | 可能丢包、依赖网络质量 | 实时监控、飞行中数据采集、多机协同 |
| TCP | 可靠传输、自动重传 | 延迟稍高、连接管理复杂 | 长距离数传、需要保证数据完整 |
3.6 本章知识体系总览
下面这张图帮你理清整个环境搭建的逻辑脉络：
3.7 快速验证：写个脚本测通整个链路
环境搭好没，跑个脚本就知道。下面这个脚本会尝试串口和 UDP 两种连接，打印出飞控的心跳信息：
from pymavlink import mavutil
import sys
def test_connection(connection_string):
"""测试 MAVLink 连接"""
try:
print(f"🔄 正在连接: {connection_string}")
master = mavutil.mavlink_connection(connection_string, timeout=5)
msg = master.wait_heartbeat(timeout=5)
if msg:
print(f"✅ 连接成功！系统ID: {msg.get_srcSystem()}, 组件ID: {msg.get_srcComponent()}")
return True
except Exception as e:
print(f"❌ 连接失败: {e}")
return False
if __name__ == "__main__":
# 测试串口（根据实际情况改端口名）
test_connection('/dev/ttyUSB0:115200')
# 测试 UDP 服务器模式
test_connection('udp:0.0.0.0:14550')
💡 调试小技巧： 如果连不上，先检查飞控是否上电、USB 线是否数据线（有些充电线不能传数据）、端口号是否正确。我在项目里被“USB 线只能充电”坑过两次，后来专门在线上贴了标签。
环境搭好了，下一步就是真正开始收数据、调参数了。别急，先把这章的内容跑通，后面咱们玩得才顺手。