ESP32+AHT25温湿度采集Tkinter GUI无法生成Pandas Excel文件求助

常见原因及解决方案 #

1. 缺失Excel处理依赖库 #

Pandas写入xlsx文件需要依赖openpyxl库，默认不会随Pandas一起安装。执行以下命令安装：

pip install openpyxl

如果是写入xls格式文件，需安装xlwt：

pip install xlwt

2. 文件路径问题 #

• 使用绝对路径：避免相对路径导致的文件找不到问题，例如：

  file_path = r"C:\Projects\sensor_data.xlsx"  # Windows
  # 或
  file_path = "/home/user/sensor_data.xlsx"  # Linux/macOS
  

• 确保文件夹存在：先检查路径所在文件夹，不存在则创建：

  import os
  folder = os.path.dirname(file_path)
  if folder and not os.path.exists(folder):
      os.makedirs(folder)
  

• 检查写入权限：不要将文件保存到系统保护目录（如C:\Windows），选择用户有权限的文件夹。

3. Pandas写入逻辑错误 #

如果是持续追加数据，需正确使用ExcelWriter的追加模式，避免每次覆盖文件。示例代码：

import pandas as pd
import os
from datetime import datetime

def save_data(temp, humi):
    # 构造新数据
    new_row = pd.DataFrame({
        "温度": [temp],
        "湿度": [humi],
        "采集时间": [datetime.now().strftime("%Y-%m-%d %H:%M:%S")]
    })
    file_path = r"./sensor_data.xlsx"
    # 处理文件夹
    folder = os.path.dirname(file_path)
    if folder and not os.path.exists(folder):
        os.makedirs(folder)
    
    try:
        if os.path.exists(file_path):
            # 追加数据到已有文件
            with pd.ExcelWriter(file_path, mode="a", engine="openpyxl", if_sheet_exists="overlay") as writer:
                # 获取当前工作表最后一行，从下一行开始写入
                start_row = writer.sheets["Sheet1"].max_row
                new_row.to_excel(writer, index=False, header=False, startrow=start_row)
        else:
            # 新建文件并写入表头
            new_row.to_excel(file_path, index=False, engine="openpyxl")
    except Exception as e:
        print(f"保存失败: {str(e)}")  # 打印错误信息定位问题

4. Tkinter线程阻塞问题 #

Tkinter主循环是单线程，如果在GUI主线程中执行Excel写入操作，可能导致阻塞甚至写入失败。建议用线程异步处理保存逻辑：

import threading

# 在获取温湿度数据的回调中调用
def on_sensor_data_received(temp, humi):
    # 更新GUI操作（必须在主线程）
    temp_label.config(text=f"温度: {temp}℃")
    humi_label.config(text=f"湿度: {humi}%")
    # 启动线程保存数据
    threading.Thread(target=save_data, args=(temp, humi), daemon=True).start()

排查步骤 #

1. 先检查openpyxl/xlwt是否安装，未安装则立即安装；
2. 修改文件路径为绝对路径，确保文件夹存在且有权限；
3. 在保存代码中添加异常捕获，打印错误信息，定位具体问题；
4. 确认写入逻辑正确，尤其是追加模式的参数设置；
5. 将保存操作放到独立线程中，避免阻塞Tkinter主循环。

内容的提问来源于stack exchange，提问作者Kuralmozhi