libxl读取excel打不开文件的常见原因：仅支持原生.xls格式（magic number d0 cf 11 e0），不支持.xlsx；文件含密码、宏或非标准结构会静默失败；必须先成功load()再获取sheet，否则空指针；运行时需libxl.dll同目录或正确路径。
libxl 读取 Excel 文件时打不开文件的常见原因
libxl 不能直接读取 .xlsx（Office Open XML）格式，只支持旧版 .xls（Excel 97–2003 Binary Format）。如果你用 Excel 2016+ 默认保存为 .xlsx，book->load() 会静默失败或返回 false，且不报具体错误——这是最常踩的坑。
- 确认文件后缀确实是
.xls，不是重命名伪装的.xlsx - 用
file yourfile.xls（Linux/macOS）或 PowerShell 的Get-FileHash+ 比对 Magic Number（D0 CF 11 E0）验证是否真为 Compound Document 格式 - libxl 免费版不支持密码保护、宏、图表等，哪怕只是设置了“打开权限密码”，
load()也会失败
C++ 中正确初始化 book 和 sheet 的顺序
必须先调用 book->load() 成功，再通过 book->getSheet(0) 或 book->getSheet("Sheet1") 获取 sheet；反着来会导致空指针解引用或崩溃。免费版 libxl 不支持 book->addSheet()，但读取时不影响。
-
Book* book = xlCreateBook();后立即检查是否为nullptr（内存不足时可能失败） -
if (!book->load("data.xls")) { /* 打印 errno 或 GetLastError() */ }，Windows 下可补FormatMessage查系统错误码 -
Sheet* sheet = book->getSheet(0);必须在load()成功后调用，否则sheet为nullptr
读取单元格内容时类型判断和转换陷阱
libxl 把单元格值统一用 CellType 区分，但 cell->getType() 返回的是枚举值，不是字符串；直接用 cell->toString() 可能返回空或乱码，尤其对数字/日期/布尔类型。
- 数值型（
CELLTYPE_NUMBER）：用cell->getNumber()，别用toString()—— 后者依赖 locale，中文 Windows 下可能返回逗号分隔的千位符 - 日期型（
CELLTYPE_DATE）：本质是浮点数（Excel 序列号），需用book->dateFromNumber()转成struct tm*，再格式化 - 空单元格（
CELLTYPE_EMPTY）：toString()返回空字符串，但getNumber()会返回 0，不能靠是否为 0 判断是否为空
Cell* cell = sheet->getCell(1, 0); // 第2行第1列
if (cell && cell->getType() == CELLTYPE_NUMBER) {
double val = cell->getNumber(); // 安全
}
Windows 下链接 libxl 的关键编译配置
libxl 提供的是静态库（libxl.lib）和 DLL（libxl.dll），C++ 项目若用 DLL 方式，必须确保运行时能找到 libxl.dll——它不会自动随 exe 发布，也不能简单扔进 system32。
- VS 项目中：在“属性 → 配置属性 → 常规 → 附加包含目录”加头文件路径；“链接器 → 常规 → 附加库目录”加
.lib路径；“链接器 → 输入 → 附加依赖项”填libxl.lib - 发布时：把
libxl.dll和 exe 放同一目录，或加到进程当前目录（SetDllDirectory()） - 注意 x86/x64 匹配：debug 版 libxl 是 MDd，release 是 MD；若项目设为 MT，则必须重新编译 libxl 源码，否则出现
LNK2005冲突
libxl 的 C++ 接口封装较薄，没有异常机制，所有错误都靠返回值和 getError() 检查；真正麻烦的不是读数据，而是提前发现并定位格式/权限/路径问题。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
