Python串口通信编程：从入门到精通的完整指南与实践64

大家好，我是你们的中文知识博主！今天，我们要深入探讨一个非常实用的“硬核”技能——串口通信编程。如果你曾经想让你的电脑与单片机、传感器或其他硬件设备进行“对话”，那么串口通信就是你必须掌握的敲门砖。别担心，我们将用简单易懂的Python语言，带你一步步攻克这个看似复杂的技术难题！
---

你有没有想过，你的电脑是如何与 Arduino、树莓派，或者是工业控制板、智能仪表这些硬件设备进行数据交换的？答案往往就在于——串口通信。作为最基础、最广泛的通信方式之一，串口通信以其简单、可靠的特点，在物联网、嵌入式开发、自动化控制等领域扮演着不可或缺的角色。

而当谈到串口通信编程时，Python无疑是一个非常棒的选择。它语法简洁、库丰富、开发效率高，使得复杂的底层操作变得平易近人。今天，我将带你从零开始，手把手学习如何使用Python进行串口通信编程，从环境搭建到数据收发，再到常见的坑点与解决方案，让你彻底掌握这项技能！

一、什么是串口通信？为什么选择Python？

在深入代码之前，我们先来快速了解一下串口通信的基本概念。

串口通信 (Serial Communication) 是一种逐位传输数据的通信方式。它不同于并行通信（一次传输多个位），而是将数据一位一位地在一条线上进行传输。虽然速度相对较慢，但只需要少数几根线（通常是发送线TX、接收线RX和地线GND），结构简单，成本低廉，因此在短距离、低速数据传输中应用极为广泛，比如连接GPS模块、温湿度传感器、蓝牙模块、RFID读写器等。

常见的串口标准有RS-232、RS-485、TTL等，它们在电平标准上有所不同，但基本的数据传输原理是相似的。现代电脑通常不再集成RS-232接口，而是通过USB转串口模块来模拟串口，或者在嵌入式系统（如树莓派）上直接提供UART（通用异步收发传输器）接口。

那么，为什么选择Python来做串口通信呢？
易学易用： Python语法简洁明了，即使是编程新手也能快速上手。
强大的`pyserial`库： Python拥有一个专门用于串口通信的第三方库`pyserial`，它封装了底层复杂的操作系统调用，提供了非常友好的API接口。
跨平台： `pyserial`库支持Windows、Linux、macOS等多种操作系统，这意味着你编写的代码可以在不同的系统上运行。
生态丰富： Python拥有庞大的科学计算、数据处理、图形界面（GUI）等库，你可以轻松地将串口数据集成到更复杂的应用中，比如数据可视化、自动化控制脚本等。

综上所述，Python无疑是进行串口通信编程的利器。

二、准备工作：硬件与软件环境搭建

工欲善其事，必先利其器。在开始编程之前，我们需要做好以下准备：

2.1 硬件准备

USB转串口模块（TTL电平）： 如果你的电脑没有物理串口，这是必需品。市面上常见的有CH340、CP2102、PL2303等芯片的模块。它能将电脑的USB信号转换为串口的TTL电平信号。
（可选）串口设备： 比如 Arduino 板（通常自带USB转串口功能）、ESP32/ESP8266开发板、或者其他具有串口接口的传感器模块。
杜邦线： 连接模块和设备的必备线材。

连接示意（以USB转TTL模块连接Arduino为例）：
USB转串口模块的TXD -> Arduino的RXD
USB转串口模块的RXD -> Arduino的TXD
USB转串口模块的GND -> Arduino的GND
（可选）USB转串口模块的VCC -> Arduino的5V/3.3V (如果设备需要外部供电，一般Arduino通过USB供电就够了)

注意：TXD和RXD要交叉连接！ 发送端（TX）连接接收端（RX），接收端（RX）连接发送端（TX）。

2.2 软件环境搭建

2.2.1 安装Python

确保你的电脑已经安装了Python 3.x 版本。你可以在Python官网 () 下载并安装。

2.2.2 安装`pyserial`库

`pyserial`是Python用于串口通信的核心库。打开你的命令行终端（Windows用户是`cmd`或`PowerShell`，macOS/Linux用户是`Terminal`），输入以下命令进行安装：pip install pyserial

如果你的电脑同时安装了Python 2和Python 3，可能需要使用`pip3`：pip3 install pyserial

2.2.3 识别串口端口号

这是至关重要的一步！你的程序需要知道它应该连接到哪个串口。不同的操作系统识别串口的方式不同：
Windows：

连接USB转串口模块后，右键点击“此电脑” -> “管理” -> “设备管理器” -> 展开“端口（COM和LPT）”。你会看到类似“USB-SERIAL CH340 (COMx)”或“USB Serial Port (COMx)”的设备，其中`COMx`就是你的串口号（例如COM3、COM4）。

你也可以在Python代码中动态列出所有可用的串口，我们稍后会讲到。
Linux：

串口设备通常以`/dev/ttyS0`、`/dev/ttyUSB0`、`/dev/ttyACM0`等形式出现。
连接设备后，可以在终端输入`ls /dev/tty*`来查看新增的设备。例如，`/dev/ttyUSB0`通常是USB转串口设备，`/dev/ttyACM0`通常是Arduino设备。

请注意，在Linux下使用串口可能需要将当前用户添加到`dialout`或`uucp`用户组中，以获得访问权限： sudo usermod -a -G dialout $USER
# 然后重启系统或注销再登录


macOS：

串口设备通常以`/dev/-xxxx`或`/dev/`等形式出现。
连接设备后，可以在终端输入`ls /dev/cu.*`来查看。

请务必记住或记录下你设备的串口号，编程时需要用到。

三、`pyserial`库核心概念与基本用法

`pyserial`库的核心是``类，它代表了一个串口连接对象。通过这个对象，我们可以配置串口参数、打开/关闭串口，以及进行数据的发送和接收。

3.1 串口参数介绍

在打开串口之前，我们需要设置一些关键参数，这些参数必须与你连接的串口设备保持一致，否则通信将无法正常进行。最常见的参数有：
`port`：串口号。例如`'COM3'` (Windows) 或 `'/dev/ttyUSB0'` (Linux)。
`baudrate`：波特率。每秒传输的比特数，常见值有9600、19200、38400、115200等。
`bytesize`：数据位。每帧数据中数据位的数量，通常为`` (8位)。
`stopbits`：停止位。每帧数据后的停止位数量，通常为`serial.STOPBITS_ONE` (1位)。
`parity`：校验位。用于错误检测，通常为`serial.PARITY_NONE` (无校验)。
`timeout`：读写超时时间（秒）。`read()`方法在等待数据时，如果超过这个时间还没收到数据，就会返回空。设置为`None`表示无限等待，设置为`0`表示非阻塞。通常建议设置一个较小的值（如1秒）。

四、Python串口通信编程步骤（核心实战）

现在，我们终于可以开始编写代码了！我们将分步讲解串口的打开、数据发送和数据接收。

步骤1：导入`serial`模块

在你的Python脚本的开头，首先要导入`serial`模块。import serial
import time # 稍后用于添加延时

步骤2：配置并打开串口

使用`()`构造函数来创建一个串口对象，并传入上述参数。建议使用`with`语句来管理串口资源，这样无论程序是否出错，串口都会自动关闭，避免资源泄露。# 根据你的操作系统和设备，修改端口号
# Windows用户示例：
# serial_port = 'COM3'
# Linux用户示例：
serial_port = '/dev/ttyUSB0'
# macOS用户示例：
# serial_port = '/dev/-A100512F'
baud_rate = 9600
try:
# 创建串口对象并打开
# 参数：端口号，波特率，数据位，停止位，校验位，读写超时时间
ser = (
port=serial_port,
baudrate=baud_rate,
bytesize=,
stopbits=serial.STOPBITS_ONE,
parity=serial.PARITY_NONE,
timeout=1 # 读超时时间，单位秒
)

if ser.is_open:
print(f"串口 {serial_port} 已成功打开，波特率 {baud_rate}")
else:
print(f"无法打开串口 {serial_port}")
except as e:
print(f"串口打开失败：{e}")
# 这里可以添加一些错误处理，例如退出程序或尝试重新连接
except Exception as e:
print(f"发生未知错误：{e}")

重要提示：
* `timeout`参数非常重要。如果设置为`None`，`read()`方法会一直阻塞直到收到数据；如果设置为`0`，`read()`会立即返回，即使没有数据。通常设置为一个较小的正值（如1秒），可以在等待数据时有一个最大等待时间。

步骤3：发送数据

向串口发送数据使用`write()`方法。需要注意的是，`write()`方法只接受字节串 (bytes) 类型的数据，而不是普通的字符串。如果你想发送字符串，需要先对其进行编码（encode）。# ... (承接步骤2的代码) ...
if ser.is_open:
try:
# 发送字符串“Hello from Python!”，注意要编码为字节串
send_data = "Hello from Python!" # 添加换行符，有些设备是按行读取的
(('utf-8')) # 使用UTF-8编码
print(f"已发送数据：'{()}'") # .strip()去除首尾空白符方便显示
(0.1) # 稍作延时，确保数据发送完成
except as e:
print(f"串口写入失败：{e}")
except Exception as e:
print(f"发送数据时发生未知错误：{e}")
# ... (稍后会讲解关闭串口) ...

编码选择： `utf-8`是通用的编码方式，但具体要看你的硬件设备期望接收什么编码。如果设备是基于ASCII的，`ascii`编码也可以。如果包含中文，`gbk`或`utf-8`是常见选择。

步骤4：接收数据

接收数据有几种常见的方法：
`(size=1)`：读取指定数量的字节。如果`timeout`设置了，会在超时后返回已读取的数据，否则会一直阻塞。
`(size=None)`：读取一行数据，直到遇到换行符``或超时。
`ser.in_waiting`：返回输入缓冲区中等待读取的字节数。可以用来判断是否有数据可读。

接收到的数据同样是字节串，如果需要显示为可读的字符串，需要进行解码（decode）。# ... (承接步骤3的代码) ...
if ser.is_open:
try:
print("开始接收数据...")
# 持续接收数据示例
while True:
# 检查是否有数据在缓冲区中
if ser.in_waiting > 0:
# 读取所有可用的字节，或者读取一行
# received_bytes = (ser.in_waiting) # 读取所有可用字节
received_bytes = () # 读取一行，直到换行符或超时
# 解码字节串为字符串
try:
received_data = ('utf-8').strip()
print(f"接收到数据：'{received_data}'")
except UnicodeDecodeError:
print(f"接收到无法解码的数据：{received_bytes}")
(0.01) # 短暂延时，避免CPU占用过高

# 可以在这里添加退出循环的条件，例如收到特定指令或用户输入
# if received_data == "quit":
# break
except as e:
print(f"串口读取失败：{e}")
except KeyboardInterrupt: # 用户按下Ctrl+C时
print("程序中断，正在关闭串口...")
except Exception as e:
print(f"接收数据时发生未知错误：{e}")
finally:
# 关闭串口
if ser.is_open:
()
print(f"串口 {serial_port} 已关闭。")

解码选择： 同样，`decode('utf-8')`是最常见的。如果解码失败，可能需要尝试其他编码，或者检查发送端和接收端的编码是否一致。

步骤5：完整示例代码

将上述片段整合起来，就是一个基本的串口通信程序。下面是一个完整的示例，它会尝试打开串口，发送一条消息，然后持续监听并打印收到的数据，直到程序被手动终止（Ctrl+C）。import serial
import time
import .list_ports # 用于列出可用串口
def list_serial_ports():
"""列出所有可用的串口"""
ports = ()
if not ports:
print("未检测到任何串口设备。")
return []
print("可用串口：")
for port, desc, hwid in sorted(ports):
print(f" {port}: {desc} [{hwid}]")
return [ for port in ports]
def main():
# 尝试列出串口并让用户选择（可选）
available_ports = list_serial_ports()
if not available_ports:
input("请连接串口设备并按Enter键重试...")
available_ports = list_serial_ports()
if not available_ports:
print("仍然没有可用串口，退出程序。")
return
# 默认使用第一个找到的串口，或手动指定
# serial_port = available_ports[0] if available_ports else 'COM3' # Windows 示例
serial_port = available_ports[0] if available_ports else '/dev/ttyUSB0' # Linux/macOS 示例
print(f"尝试连接串口：{serial_port}")
baud_rate = 9600
ser = None # 初始化串口对象
try:
# 创建串口对象并打开
ser = (
port=serial_port,
baudrate=baud_rate,
bytesize=,
stopbits=serial.STOPBITS_ONE,
parity=serial.PARITY_NONE,
timeout=1 # 读超时时间，单位秒
)
if ser.is_open:
print(f"串口 {serial_port} 已成功打开，波特率 {baud_rate}")
else:
print(f"无法打开串口 {serial_port}")
return
# --- 发送数据示例 ---
send_data = "Hello World from Python!"
(('utf-8'))
print(f"已发送数据：'{()}'")
(0.1) # 稍作延时
# --- 接收数据示例 ---
print("开始持续接收数据... (按 Ctrl+C 退出)")
while True:
if ser.in_waiting > 0:
received_bytes = () # 读取一行
try:
received_data = ('utf-8').strip()
print(f"接收到数据：'{received_data}'")
except UnicodeDecodeError:
print(f"接收到无法解码的数据：{received_bytes}")
(0.01) # 避免CPU占用过高
except as e:
print(f"串口操作失败：{e}")
if "No such file or directory" in str(e) or "The system cannot find the file specified" in str(e):
print("请检查串口端口号是否正确，或设备是否已连接。")
elif "Access is denied" in str(e) or "Permission denied" in str(e):
print("在Linux/macOS上，请检查当前用户是否有串口访问权限。")
except KeyboardInterrupt:
print("程序被用户中断。")
except Exception as e:
print(f"发生未知错误：{e}")
finally:
if ser and ser.is_open:
()
print(f"串口 {serial_port} 已关闭。")
if __name__ == "__main__":
main()

五、进阶与常见问题解决方案

掌握了基本操作后，我们来看一些更深入的问题和实践中的“坑”。

5.1 列出所有可用串口

手动查找串口号有时候很麻烦，`pyserial`提供了工具函数来动态获取：import .list_ports
ports = ()
if not ports:
print("未检测到任何串口设备。")
else:
print("可用串口：")
for port, desc, hwid in sorted(ports):
print(f" {port}: {desc} [{hwid}]")
# 是串口的完整路径，例如 'COM3' 或 '/dev/ttyUSB0'
# 设备的描述，例如 'USB-SERIAL CH340'
# 硬件ID

5.2 错误处理与鲁棒性

在实际应用中，串口可能会突然断开，或者在写入时出现问题。良好的错误处理是必不可少的。
`try...except `： 捕获与串口操作相关的特定异常，例如串口不存在、权限不足、串口被占用等。
`finally`块： 确保无论是否发生异常，串口都能被正确关闭，释放资源。
重连机制： 在关键应用中，当串口断开时，可以尝试定期重新打开串口。

5.3 线程安全与并发读取

如果你需要在主程序执行其他任务的同时，在后台持续监听串口数据（例如，更新GUI界面），那么你可能需要用到多线程。将串口读取操作放到一个单独的线程中，可以避免主线程阻塞。import threading
import queue
class SerialReader():
def __init__(self, ser_port, data_queue):
super().__init__()
= ser_port
self.data_queue = data_queue
= True
def run(self):
print(f"串口读取线程启动，监听 {}")
while :
try:
if .in_waiting > 0:
received_bytes = ()
try:
received_data = ('utf-8').strip()
(received_data) # 将数据放入队列
except UnicodeDecodeError:
(f"[ERROR] UnicodeDecodeError: {received_bytes}")
(0.01)
except as e:
print(f"串口读取线程出错：{e}")
= False # 停止线程
except Exception as e:
print(f"串口读取线程发生未知错误：{e}")
= False
print("串口读取线程退出。")
# --- 主程序示例 ---
# if __name__ == "__main__":
# ser = (...) # 初始化串口
# data_queue = () # 用于线程间通信
# reader_thread = SerialReader(ser, data_queue)
# () # 启动读取线程
# # 主程序可以做其他事情，并从队列中获取数据
# while True:
# if not ():
# data = ()
# print(f"主程序处理数据：{data}")
# (0.1)
# # 添加退出条件
# = False # 停止线程
# () # 等待线程结束
# ()

使用``可以在不同线程之间安全地传递数据。

5.4 数据协议与帧格式

在实际项目中，简单地发送字符串或一行数据通常是不够的。你需要与硬件设备约定一个数据协议，例如：
帧头/帧尾： 用特定的字节序列标识一帧数据的开始和结束，例如`0xAA 0x55 ... 0x0D 0x0A`。
数据长度： 帧头后跟着一个字节表示后续数据的长度，方便接收方知道要读取多少字节。
命令字/功能码： 标识这帧数据是做什么用的（例如，读取温度、设置参数）。
数据内容： 实际传输的数据。
校验码： 例如CRC（循环冗余校验）、LRC（纵向冗余校验）或简单的求和校验，用于验证数据传输的完整性和准确性。

实现这些协议会增加代码的复杂度，但能大大提高通信的可靠性。

5.5 常见问题与解决办法

端口号错误或端口被占用：

问题： `: [Errno 2] No such file or directory` (Linux/macOS) 或 `[Errno 22] Invalid argument` / `[Errno 5] Access is denied` (Windows)
解决： 确保串口号正确。Windows下检查设备管理器，Linux/macOS下使用`ls /dev/tty*`。如果被占用，请关闭占用该串口的其他程序（如串口调试助手）。在Linux下，确保当前用户有串口访问权限（添加到`dialout`或`uucp`组）。


波特率不匹配：

问题： 接收到的数据是乱码。
解决： 确保Python程序中设置的波特率与硬件设备的波特率完全一致。这是最常见的乱码原因。


编码/解码错误：

问题： `UnicodeDecodeError: 'utf-8' codec can't decode byte ...`
解决： 检查发送方和接收方使用的编码是否一致。如果发送方发送的是原始字节数据而不是字符串，你可能不需要`decode()`，或者需要尝试其他编码（如`latin-1`）。


数据丢失或不完整：

问题： 接收到的数据不完整或部分丢失。
解决：

检查发送端是否发送了换行符。`readline()`依赖换行符。
增加`()`延时，确保数据完全发送或接收。
调整`timeout`参数，给`read()`或`readline()`足够的等待时间。
考虑使用数据协议（帧头/帧尾/长度/校验），确保数据完整性。
检查硬件连接是否稳定，线材是否有问题。




硬件连接问题：

问题： 完全没有数据收发。
解决：

检查TXD和RXD是否交叉连接。
检查GND是否连接。
确认设备是否已正确供电。
使用串口调试助手测试硬件是否正常工作，排除Python程序问题。

六、总结与展望

通过本文，我们已经完整学习了使用Python进行串口通信编程的各个方面：从理解基本概念、搭建环境，到实际编写代码实现数据的发送与接收，再到解决常见问题和掌握进阶技巧。

现在，你已经掌握了与各种硬件设备“对话”的能力！这扇门一打开，你可以做的事情就非常多了：
读取各种传感器的实时数据，进行数据分析和可视化。
通过电脑控制单片机（如Arduino）上的继电器、LED灯、电机等。
开发自定义的硬件测试工具。
集成到更复杂的自动化或物联网项目中。

希望这篇详细的指南能帮助你顺利踏上Python串口通信的旅程。实践是最好的老师，多动手尝试，多思考，你一定能成为一名优秀的“硬核”创客！如果你在实践过程中遇到任何问题，欢迎在评论区留言，我们一起交流进步！

下次见！

2025-11-18

---

上一篇：Python新手入门：零基础环境搭建全攻略

下一篇：雅安Python少儿编程全攻略：考题解析、学习路径与计算思维培养指南