在 Python 中接收串口数据并生成 Excel 表格，通常涉及以下核心步骤： 1. **串口通信**：使用 `pyserial` 库打开串口（如 COM3 或 `/dev/ttyUSB0`），持续读取数据（可按行、按字节或按特定分隔符解析）； 2. **数据解析与存储**：将接收到的原始字节流解码为字符串，按协议（如 CSV 格式、JSON、空格/逗号分隔等）解析成结构化数据（如字典、列表）； 3. **Excel 生成**：使用 `openpyxl`（支持 `.xlsx`，可写样式、公式、多工作表）或 `pandas + openpyxl/xlsxwriter`（适合批量数据导出）生成 Excel 文件。 ✅ 推荐方案： - 使用 `pyserial` 实时读取串口（带超时和异常处理）； - 使用 `pandas` 统一管理数据（DataFrame 易扩展、易保存）； - 使用 `pandas.DataFrame.to_excel()` + `openpyxl` 引擎保存为 `.xlsx`（兼容性好、无需手动创建工作表）。 --- ### ✅ 完整可运行示例代码（含注释） ```python import serial import pandas as pd import time from datetime import datetime import sys # ------------------------ 配置区（请按实际硬件修改） ------------------------ SERIAL_PORT = "COM3" # Windows 示例；Linux 用 "/dev/ttyUSB0" 或 "/dev/ttyACM0" BAUD_RATE = 9600 # 波特率，需与设备一致 TIMEOUT = 1 # 串口读取超时（秒） MAX_LINES = 1000 # 最大接收行数（防内存溢出，可设为 None 表示不限） DELIMITER = "," # 假设设备发送的是逗号分隔数据，如："25.3,1013.2,45.7,\r\n" COLUMN_NAMES = ["Temperature(°C)", "Pressure(hPa)", "Humidity(%)"] # 列名（根据实际传感器字段调整） # ------------------------ 初始化串口 ------------------------ try: ser = serial.Serial( port=SERIAL_PORT, baudrate=BAUD_RATE, timeout=TIMEOUT, bytesize=serial.EIGHTBITS, parity=serial.PARITY_NONE, stopbits=serial.STOPBITS_ONE ) print(f"✅ 已成功连接串口: {SERIAL_PORT} @ {BAUD_RATE} bps") except serial.SerialException as e: print(f"❌ 串口打开失败: {e}") sys.exit(1) # ------------------------ 数据容器 ------------------------ data_list = [] print("⏳ 正在接收数据... 按 Ctrl+C 停止并保存 Excel") print(f"💡 提示：设备应发送形如 '{','.join(['123.4']*len(COLUMN_NAMES))}' 的逗号分隔行") try: while True: # 读取一行（以 \n 或 \r\n 结尾） line = ser.readline() if not line: continue # 超时无数据，跳过 try: # 解码为字符串，并去除首尾空白（含\r\n） text = line.decode('utf-8').strip() if not text: continue # 按分隔符分割（例如 "25.3,1013.2,45.7" → [25.3, 1013.2, 45.7]） parts = text.split(DELIMITER) if len(parts) != len(COLUMN_NAMES): print(f"⚠️ 跳过格式异常行（字段数不匹配）: {text}") continue # 尝试转换为浮点数（可根据需要改为 int/str） row_data = [] for i, val in enumerate(parts): try: row_data.append(float(val.strip())) except ValueError: print(f"⚠️ 第{i+1}列 '{val}' 无法转为数字，填入 NaN") row_data.append(float('nan')) # 添加时间戳（可选但强烈推荐） row_data.append(datetime.now()) data_list.append(row_data) # 实时打印（可选） print(f"📊 接收 [{len(data_list)}]: {row_data[:-1]}") # 达到上限则停止（可删除此段实现无限采集） if MAX_LINES and len(data_list) >= MAX_LINES: print(f"✅ 已达最大行数 {MAX_LINES}，自动停止采集。") break except UnicodeDecodeError: print(f"⚠️ 解码失败（非UTF-8字节）: {line!r}") except Exception as e: print(f"⚠️ 解析异常: {e}") except KeyboardInterrupt: print("\n⏹️ 用户中断采集。正在保存数据...") finally: ser.close() print("🔌 串口已关闭。") # ------------------------ 生成 Excel ------------------------ if not data_list: print("❌ 未接收到任何有效数据，Excel 未生成。") else: # 构建 DataFrame（注意：时间戳列名） timestamp_col = "Timestamp" df = pd.DataFrame(data_list, columns=COLUMN_NAMES + [timestamp_col]) # 生成文件名（含时间戳，避免覆盖） filename = f"serial_data_{datetime.now().strftime('%Y%m%d_%H%M%S')}.xlsx" try: # 保存为 Excel（使用 openpyxl 引擎，支持 .xlsx） df.to_excel(filename, index=False, engine='openpyxl') print(f"✅ Excel 已保存: {filename}") print(f"📋 共 {len(df)} 行数据，列名: {list(df.columns)}") except Exception as e: print(f"❌ Excel 保存失败: {e}") ``` --- ### 🔍 关键说明与注意事项： | 模块 | 作用 | 注意事项 | |------|------|----------| | `serial.Serial` | 建立串口连接 | 必须确保端口号正确、设备已插好、驱动已安装（如 CH340、CP2102）、无其他程序占用该端口（如 Arduino IDE 的串口监视器） | | `line.decode('utf-8')` | 字节→字符串 | 若设备发 GBK/ASCII，请改用 `'gbk'` 或 `'ascii'`；建议设备统一用 UTF-8 | | `split(DELIMITER)` | 协议解析 | 若设备发 JSON（如 `{"temp":25.3,"humi":45}`），可用 `json.loads(text)` 替代；若为固定二进制帧，需用 `struct.unpack()` 解析 | | `pandas.DataFrame` | 数据结构化 | 自动处理缺失值（NaN）、类型推断、时间对齐；后续可轻松做统计（`df.describe()`）、绘图（`df.plot()`）等 | | `to_excel(..., engine='openpyxl')` | 写入 Excel | 需提前安装：`pip install openpyxl pandas pyserial`；`xlsxwriter` 不支持读/改已有文件，`openpyxl` 支持（但本例是新建） | --- ### 🛠️ 依赖安装命令（首次运行前执行）： ```bash pip install pyserial pandas openpyxl ``` --- ### 💡 进阶建议（可选增强）： - ✅ 添加 GUI（用 `tkinter` / `PyQt5`）实现“开始/停止/配置”按钮； - ✅ 支持实时绘图（`matplotlib.animation`）； - ✅ 数据校验与滤波（如滑动平均去噪）； - ✅ 自动分表（每 1000 行一个 sheet）； - ✅ 导出 CSV + Excel 双备份； - ✅ 日志记录（`logging` 模块）错误与状态。 ---