本文详解如何在 python 中稳定、可靠地向 com端口 发送单 字节 数值（如数字 21），重点解决因数据类型错误和超时设置不当导致的程序阻塞问题，并提供可立即运行的定时发送示例。
在 Python 中使用 pyserial 库向串口（如 COM4）发送数据时，一个常见误区是直接传入整数（如 ser.write(21)）。实际上，serial.Serial.write()方法 严格要求输入为 bytes 类型对象 ，而非 int。若传入整数，会触发 TypeError（在较新版本中）或引发未定义行为；而即使强制转换成功，若未配置写操作超时（write_timeout），当目标设备未就绪或响应异常时，write() 仍可能无限阻塞——这正是原代码“卡住”的根本原因。
✅ 正确做法：字节化 + 写超时 + 定时循环
首先，将数字转换为单字节 bytes 对象：bytes([21])（注意方括号，表示含一个元素的列表）；其次，显式设置 write_timeout=0（非阻塞写）或一个合理正数值（如 write_timeout=1），避免写操作挂起；最后，结合 time.sleep()实现精确间隔发送。
以下是发送数字 21 到 COM4、每秒一次、持续 5 秒的完整可运行代码：
import serial import time # 配置串口：指定 write_timeout（非 timeout！）ser = serial.Serial('COM4', 9600, write_timeout=0) # 构造单字节数据：数字 21 对应的字节 data_byte = bytes([21]) try: for i in range(5): # 执行写入，返回实际发送的字节数（通常为 1）n = ser.write(data_byte) print(f"第 {i+1} 次：成功发送 {n} 字节（值：{data_byte[0]}）") time.sleep(1) finally: ser.close() # 确保资源释放 print("发送完成")⚠️ 关键注意事项
- timeout ≠ write_timeout：timeout 控制 read()操作的等待时长，对 write()无效；必须使用 write_timeout 参数。
- write_timeout=0 表示非阻塞模式 ：若底层无法立即写入（如缓冲区满、设备断开），write() 将立即返回 0 并抛出 serial.TimeoutException（需捕获处理）；生产环境建议设为 1 等小正数以兼顾可靠性与响应性。
- 验证接收端 ：使用 com0com 创建的虚拟串口对（如 COM3↔COM4）时，可在另一端用串口调试 工具（如 PuTTY、Arduino Serial Monitor）监听 COM3，确认是否收到 0x15（即十进制 21）。
- 权限与端口占用：确保 Python 进程有串口访问权限，且 COM4 未被其他程序独占打开。
通过以上修正，即可实现稳定、可控的串口数字发送——不再卡死，精准定时，易于集成到自动化或嵌入式通信场景中。
立即学习“Python 免费学习笔记（深入）”；
