4、pySerial基础操作：打开/关闭串口、配置参数（端口、波特率、超时）
好，咱们进入实战环节的第一个硬骨头——pySerial。说实话，很多初学者一上来就写代码，结果串口打不开、数据读不到，折腾半天发现是参数配错了。我当年也干过这种事，调了一下午，最后发现波特率设成了9600，设备那边是115200……嗯，这种低级错误，犯过一次就记住了。
4.1 安装与导入：第一步别走偏
pySerial不是Python自带的库，你得先装。我个人习惯用pip安装，简单粗暴：
pip install pyserial装完之后，在代码里导入：
import serial注意，是serial，不是pyserial。我见过有人写import pyserial，结果报错半天找不到原因。你想想看，库名叫pySerial，但导入的时候用的是serial，这确实有点反直觉。
4.2 打开串口：两种方式，任你选
打开串口有两种方式，我一般用第一种，因为更直观。
方式一：创建实例时直接配置
import serial
ser = serial.Serial(
port='COM3', # Windows下用COM口，Linux下用/dev/ttyUSB0
baudrate=115200, # 波特率
timeout=1 # 超时时间，单位秒
)这种方式一步到位，适合大多数场景。但要注意，如果串口被其他程序占用了，这里会直接报错。我在项目中遇到过这种情况——调试的时候开了两个终端，结果第二个就打不开了。
方式二：先创建实例，再手动打开
ser = serial.Serial()
ser.port = 'COM3'
ser.baudrate = 115200
ser.timeout = 1
ser.open()这种方式更灵活，适合需要动态修改参数的场景。比如你写了一个配置界面，让用户自己选端口和波特率，那就用这种方式。
open()之前，一定要确保所有参数都设置好了。我曾经漏设了波特率，结果默认是9600，和设备对不上，数据全是乱码。嗯，这种问题排查起来特别费劲。
4.3 配置参数：端口、波特率、超时
这三个参数是串口通信的核心，说白了就是“跟谁说话、说多快、等多久”。
| 参数 | 说明 | 常见值 |
|---|---|---|
| port | 串口端口号 | Windows: COM1~COM256 Linux: /dev/ttyUSB0, /dev/ttyAMA0 |
| baudrate | 波特率，即每秒传输的符号数 | 9600, 19200, 38400, 115200, 921600 |
| timeout | 读取超时时间（秒） | None（阻塞）、0（非阻塞）、正数（超时秒数） |
端口（port）：Windows下是COM口，Linux下是tty设备。怎么查？Windows去设备管理器看，Linux用ls /dev/tty*。我建议你写代码的时候，先手动确认一下端口号，别想当然。
波特率（baudrate）：这个必须和设备一致。设备说115200，你就得设115200，差一点都不行。我记得有一次调试飞控，波特率设成了57600，飞控那边是115200，结果读上来的数据全是乱码，我还以为是硬件坏了……
超时（timeout）：这个参数很关键。设成None表示一直等，直到读到数据；设成0表示不等，没数据就返回；设成正数表示最多等多少秒。我一般设成1秒，既不会卡死，也不会频繁空转。
None，一旦设备不发送数据，你的程序就卡死了。我建议在正式项目中，永远不要用None，至少设个1秒或2秒。
4.4 关闭串口：别忘了收尾
用完串口一定要关掉，不然下次就打不开了。代码很简单：
ser.close()但问题是，很多人写着写着就忘了。我建议用with语句来自动管理：
with serial.Serial('COM3', 115200, timeout=1) as ser:
# 在这里读写数据
pass
# 退出with块后，串口自动关闭这种方式最安全，不会因为异常退出而漏掉close()。我在项目中一直用这种方式，省心。
with语句了。
4.5 完整示例：打开、配置、关闭一条龙
下面是一个完整的示例，包含了打开、配置、读写和关闭：
import serial
import time
try:
# 打开串口
ser = serial.Serial(
port='COM3',
baudrate=115200,
timeout=1
)
print(f"串口已打开: {ser.port}, 波特率: {ser.baudrate}")
# 发送数据
ser.write(b'Hello, World!\n')
# 读取数据
response = ser.readline()
print(f"收到: {response}")
# 等待一会儿
time.sleep(0.1)
except serial.SerialException as e:
print(f"串口错误: {e}")
finally:
# 确保关闭串口
if 'ser' in locals() and ser.is_open:
ser.close()
print("串口已关闭")这个例子虽然简单，但包含了所有关键步骤。你想想看，实际项目中无非就是在这个基础上加循环、加协议解析、加异常处理。
4.6 知识体系总览
下面这张图帮你理清pySerial基础操作的核心逻辑：
这张图把pySerial基础操作的三个核心环节串起来了。你从“打开串口”开始，根据场景选合适的方式；然后配置端口、波特率、超时这三个关键参数；最后别忘了关闭串口。说白了，就是这三步走。
好了，pySerial的基础操作就这些。记住：端口要对、波特率要匹配、超时要有、用完要关。这四个要点记住了，串口通信的第一步就算站稳了。
可可精品资料库