常见原因有三：路径错误导致FileNotFoundError或空DataFrame；Excel进程独占文件致静默返回空；表头含空格或特殊字符引发KeyError。
用 pandas.read_excel 读取测试用例时，为什么总报 FileNotFoundError 或空 DataFrame？
路径没写对是最常见原因——Python 当前工作目录不等于脚本所在目录。尤其在 IDE（如 PyCharm）或命令行中执行时，os.getcwd() 可能指向项目根目录、用户主目录，甚至临时目录。
- 用
Path(__file__).parent / "test_data.xlsx"替代硬编码相对路径，确保基于脚本位置找文件 - 检查 Excel 文件是否被 Excel 进程独占（保存后仍打不开就关掉 Excel），否则
pandas会静默返回空DataFrame - 如果表头含空格或特殊字符，
pandas默认会重命名列（如"输入数据 "→"输入数据.1"），导致后续用df["输入数据"]报KeyError
测试用例里有布尔值、日期、数字混填，read_excel 自动类型推断错得离谱怎么办？
pandas 默认用 infer_dtype 猜列类型，但测试表常出现“同一列前几行是数字、后面是字符串或空”，结果整列变成 object，再想转 bool 或 datetime 就得手动清理。
- 显式传
dtype参数：比如dtype={"是否启用": bool, "创建时间": str}，避免自动推断 - 对日期列，别依赖
parse_dates，先读成str，再用pd.to_datetime(df["创建时间"], errors="coerce")处理异常值（errors="coerce"把错的变NaT，不是崩） - 布尔列慎用
True/False文字：Excel 里填 “是/否”、“Y/N”、“1/0” 更稳定，然后用map({"是": True, "否": False})
一个 Excel 文件多个 sheet，怎么按测试场景名精准加载对应 tab？
直接写 sheet_name="登录测试" 看似简单，但实际中 sheet 名常带空格、括号、隐藏字符，或大小写不一致（比如 Excel 显示 “登录测试”，实际是 “登录测试 ”），pandas 会直接抛 ValueError: Worksheet named '登录测试' not found。
- 先用
pd.ExcelFile(file_path).sheet_names打印所有真实 sheet 名，肉眼核对 - 用
sheet_name传整数索引（如0）更可靠，尤其当 sheet 顺序固定时 - 如果必须按名匹配，加一层容错：用
[s for s in sheets if "登录" in s]模糊查找，再取第一个，比硬匹配少踩坑
测试脚本跑 CI 时读 Excel 失败，本地却好好的？
CI 环境（如 GitHub Actions、GitLab CI）默认没装 Excel 引擎依赖。pandas.read_excel 在无 openpyxl 或 xlsxwriter 时，会 fallback 到 xlrd，而新版 xlrd（≥2.0）已不支持 .xlsx，只认 .xls。
立即学习“Python免费学习笔记（深入）”；
- 明确安装
openpyxl：pip install openpyxl，并在读取时指定engine="openpyxl" - CI 的
requirements.txt必须包含openpyxl，不能只写pandas - 避免用
xlrd：它已被弃用，且对中文路径、合并单元格支持差，测试数据一复杂就出问题
Excel 测试数据真正的麻烦不在读，而在“人填的时候不守规矩”——合并单元格、空行、动态增删列、用颜色标记状态……这些都不会报错，但会让 DataFrame 结构偏移，等断言失败才暴露。所以读完最好加一行校验：assert len(df) > 0 and "用例编号" in df.columns。
