4、MAVLink开发环境搭建：安装Python环境、安装pymavlink库、安装MAVSDK、验证开发环境

说实话，很多初学者一上来就急着写代码，结果卡在环境配置上大半天。我见过太多人花了两天装库，最后发现是Python版本不对。嗯，这一章咱们就把地基打牢。

开发环境说白了就三样东西：Python运行时、pymavlink库、MAVSDK。装好了，后面写代码才顺手。

4.1 安装Python环境

我个人习惯用Python 3.8到3.11之间的版本。为什么？因为pymavlink和MAVSDK对这些版本支持最稳定。Python 3.12刚出的时候我试过，有些依赖库还没跟上，踩过坑。

Windows用户：

1. 去Python官网下载安装包，选3.10.x版本。
2. 安装时记得勾选"Add Python to PATH"。这一步很多人漏掉，结果命令行里打python没反应。
3. 打开命令提示符，输入python --version验证。

Linux/macOS用户：

1. Linux一般自带Python，但版本可能偏旧。用python3 --version检查。
2. 如果版本低于3.8，用包管理器升级：sudo apt install python3.10（Ubuntu）或brew install python@3.10（macOS）。
3. 建议用python3 -m venv创建虚拟环境，避免库冲突。

4.2 安装pymavlink库

pymavlink是MAVLink协议的Python实现。说白了，它帮你把无人机发来的二进制数据解析成能看懂的消息。

安装命令很简单：

pip install pymavlink

如果你在Linux上遇到权限问题，加个--user参数：

pip install --user pymavlink

我曾经在树莓派上装pymavlink，结果编译C扩展时卡住了。后来发现是缺了libxml2-dev和libxslt1-dev。嗯，Linux用户如果报编译错误，先装这两个依赖：

sudo apt install libxml2-dev libxslt1-dev
pip install pymavlink

验证安装：

python -c "import pymavlink; print(pymavlink.__version__)"

如果输出版本号，比如2.4.41，说明装好了。

4.3 安装MAVSDK

MAVSDK是更高层的库，封装了常见的无人机操作：起飞、降落、航线飞行。它底层还是走MAVLink协议，但接口更友好。

安装方式：

pip install mavsdk

MAVSDK依赖一个后台服务mavsdk_server。这个服务负责和飞控通信。安装时会自动下载，但如果你在离线环境，需要手动处理。

验证安装：

python -c "import mavsdk; print(mavsdk.__version__)"

如果输出类似2.0.0，就对了。

4.4 验证开发环境

环境装好了，得跑个真东西验证一下。下面这个脚本会尝试连接一个模拟的无人机（SITL），读取心跳消息。

# test_mavlink_env.py
import asyncio
from mavsdk import System

async def run():
    drone = System()
    await drone.connect(system_address="udp://:14540")

    print("等待无人机连接...")
    async for state in drone.core.connection_state():
        if state.is_connected:
            print(f"已连接到无人机")
            break

    print("获取心跳...")
    async for heartbeat in drone.telemetry.heartbeat():
        print(f"心跳类型: {heartbeat.type}")
        break

if __name__ == "__main__":
    asyncio.run(run())

运行前需要启动一个模拟无人机。用ArduPilot的SITL：

sim_vehicle.py -v ArduCopter --console --map

然后在另一个终端运行测试脚本：

python test_mavlink_env.py

如果看到已连接到无人机和心跳类型: 2（2代表旋翼机），说明环境完全OK。

4.5 知识体系总览

下面这张图把整个开发环境的结构画清楚了。你想想看，从最底层的Python运行时，到中间的pymavlink和MAVSDK，再到最上层的应用代码，每一层都有它的职责。

这张图里，从上往下看：你的应用代码调用MAVSDK的接口，MAVSDK内部用pymavlink解析MAVLink协议，pymavlink跑在Python运行时上。每一层都依赖下一层，但上层不用关心下层的实现细节。这就是分层设计的好处。

4.6 常见问题与解决

问题	原因	解决方法
pip: command not found	Python未加入PATH	重新安装Python并勾选"Add to PATH"
ImportError: No module named pymavlink	库未安装或虚拟环境未激活	检查pip list，激活正确的虚拟环境
DLL load failed	缺少VC++运行库	安装Visual C++ Redistributable
Connection refused	SITL未启动或端口不对	确认SITL运行中，检查UDP端口号