3. Python环境搭建与库安装

说实话，很多做无人机开发的朋友，一开始都栽在环境搭建上。我记得刚入行那会儿，光装一个串口库就折腾了大半天，最后发现是Python版本不对。嗯，这节课咱们就把这些坑提前填上。

你要解析无人机遥测数据，说白了就是让电脑能听懂飞控在说什么。而Python，就是我们和飞控沟通的翻译官。下面我带你一步步把这位翻译官请出来。

3.1 Python基础环境安装

我个人习惯用Python 3.8以上的版本。为什么？因为pymavlink对3.8支持最稳，我在几个项目里都验证过。你如果装3.10或3.11也行，但有些旧版库可能会报兼容性警告。

3.1.1 下载与安装

1. 打开Python官网，下载对应系统的安装包。
2. 安装时记得勾选 "Add Python to PATH" —— 这一步我吃过亏，没勾的话命令行里敲python会提示找不到命令。
3. 安装完成后，打开终端（Windows用cmd或PowerShell，Mac/Linux用终端），输入：

python --version

如果看到类似 Python 3.9.7 的输出，说明环境装好了。

3.1.2 虚拟环境（强烈推荐）

你想想看，一个项目用pymavlink 2.4，另一个项目用2.6，如果全装全局环境，迟早会打架。我建议每个项目都建一个独立的虚拟环境。

# 创建虚拟环境
python -m venv drone_env

# 激活环境（Windows）
drone_env\Scripts\activate

# 激活环境（Mac/Linux）
source drone_env/bin/activate

激活后，终端前面会出现 (drone_env) 字样，说明你已经在虚拟环境里了。这时候安装的所有库，都只在这个项目里生效。

3.2 pymavlink库安装

pymavlink是MAVLink协议的Python实现。MAVLink是什么？说白了就是飞控和地面站之间的通信语言。你要解析遥测数据，就得靠这个库来翻译飞控发出来的二进制数据包。

3.2.1 安装命令

确保虚拟环境已激活，然后执行：

pip install pymavlink

如果你在Windows上遇到编译报错，别慌。pymavlink底层依赖C扩展，Windows缺编译器。我遇到过好几次，解决方案是装一个预编译的wheel包：

pip install pymavlink --only-binary :all:

或者直接去PyPI下载对应Python版本的.whl文件手动安装。

3.2.2 验证安装

装完后，进Python交互环境测试一下：

python
>>> from pymavlink import mavutil
>>> print(mavutil.__version__)
2.4.34  # 你看到的版本可能不同，但只要有输出就说明装好了

3.3 serial库安装

serial库，全称pyserial，是Python和串口通信的桥梁。无人机飞控通常通过USB转串口（比如USB-TTL）和电脑连接，你要读取遥测数据，就得靠它。

3.3.1 安装命令

pip install pyserial

注意，库名叫 pyserial，但导入时用的是 import serial。我第一次用的时候就搞混过，pip install serial装了个不知道什么东西……

3.3.2 验证安装

python
>>> import serial
>>> print(serial.__version__)
3.5  # 有输出就OK

3.3.3 串口权限（Linux/Mac用户注意）

在Linux上，普通用户默认没有权限访问串口设备。我刚开始用树莓派连飞控时，代码一直报权限错误，查了半天才发现是这个问题。

解决方法：把当前用户加到 dialout 组：

sudo usermod -a -G dialout $USER

然后注销重新登录，或者重启一下。

3.4 知识体系总览

下面这张图，把本章的核心逻辑串起来了。你一看就明白：Python环境是地基，pymavlink和serial是两根柱子，共同撑起遥测数据解析这座房子。

3.5 安装清单速查表

为了方便你对照检查，我把所有安装步骤整理成了一张表。你装完一项就打个勾，不容易漏。

步骤	命令/操作	验证方法	常见问题
1. 安装Python	官网下载安装包	python --version	未勾选"Add to PATH"
2. 创建虚拟环境	python -m venv drone_env	终端显示 (drone_env)	未激活环境就装库
3. 安装pymavlink	pip install pymavlink	from pymavlink import mavutil	Windows缺编译器，加 --only-binary :all:
4. 安装pyserial	pip install pyserial	import serial; print(serial.__version__)	注意是 pyserial 不是 serial
5. 配置串口权限	sudo usermod -a -G dialout $USER	能打开 /dev/ttyUSB0 等设备	Linux/Mac需要，Windows一般不用

3.6 快速验证脚本

最后，我给你准备了一个小脚本。把它保存为 check_env.py，运行一下就能确认所有环境都就绪了。

#!/usr/bin/env python3
"""
环境验证脚本：检查Python、pymavlink、serial是否安装正确
"""
import sys

def check_python():
    print(f"[OK] Python版本: {sys.version}")
    return True

def check_pymavlink():
    try:
        from pymavlink import mavutil
        print(f"[OK] pymavlink版本: {mavutil.__version__}")
        return True
    except ImportError:
        print("[FAIL] pymavlink未安装")
        return False

def check_serial():
    try:
        import serial
        print(f"[OK] pyserial版本: {serial.__version__}")
        return True
    except ImportError:
        print("[FAIL] pyserial未安装")
        return False

if __name__ == "__main__":
    print("=" * 40)
    print("无人机遥测环境检查")
    print("=" * 40)
    
    all_ok = True
    all_ok &= check_python()
    all_ok &= check_pymavlink()
    all_ok &= check_serial()
    
    print("=" * 40)
    if all_ok:
        print("🎉 所有环境就绪，可以开始解析遥测数据了！")
    else:
        print("⚠️  有组件未安装，请检查上面的提示。")