用Arrow C++读Parquet文件是最可靠的选择，必须依赖Apache Arrow的C++实现，它提供稳定、高性能、跨平台的parquet::ParquetFileReader接口，且与Python（pyarrow）、Java语义对齐；常见错误是漏链libarrow或未启用-DARROW_PARQUET=ON编译。
用Arrow C++读Parquet文件是最可靠的选择
别折腾自己写解析器，也别指望标准库支持——C++原生不带Parquet读取能力。必须依赖Apache Arrow的C++实现，它提供稳定、高性能、跨平台的parquet::ParquetFileReader接口，且与Python（pyarrow）、Java（Arrow Java）语义对齐，数据类型映射清晰。
常见错误是直接链接libparquet但漏掉Arrow核心库，导致链接失败或Segmentation fault；另一个坑是未启用Arrow构建时的PARQUET组件（默认可能关闭），编译时会报undefined reference to parquet::ParquetFileReader::Open。
- 确保Arrow以
-DARROW_PARQUET=ON编译（若用vcpkg：运行vcpkg install arrow[parquet]） - 链接顺序必须为：
-larrow -lparquet -lzstd -llz4 -lsnappy（压缩库顺序不能颠倒） - 头文件包含路径需同时有
arrow/api.h和parquet/arrow/reader.h
读取单个Parquet文件并转成Arrow Table
这是最常用场景：把整个文件加载进内存做后续计算。关键在于用parquet::arrow::FileReader桥接Parquet和Arrow生态，而不是直接操作底层parquet::ParquetFileReader（它只返回parquet::FileReader，没列式数据结构）。
示例代码片段：
立即学习“C++免费学习笔记（深入）”；
#include <arrow/api.h>
#include <parquet/arrow/reader.h>
#include <parquet/file_reader.h>
std::shared_ptr<arrow::Table> table;
auto reader = parquet::arrow::FileReader::Open(
*parquet::ParquetFileReader::Open(input_file),
arrow::default_memory_pool());
reader->ReadTable(&table); // 同步读取全部行组
注意：ReadTable()会一次性解压并解码所有列，内存占用≈原始Parquet大小×2~5倍（取决于压缩率和数据类型）。如果文件超1GB，务必考虑分块读取。
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
按行组（Row Group）流式读取避免OOM
大文件（>2GB）或内存受限环境必须跳过ReadTable()，改用ReadRowGroup()逐块处理。每个行组是独立编码单元，通常对应一个磁盘块（默认约128MB原始数据）。
典型流程：
- 先调用
reader->metadata()->num_row_groups()获取总行组数 - 循环调用
reader->ReadRowGroup(i, &table_chunk)，每次只加载一个行组到内存 - 处理完立即释放
table_chunk（table_chunk.reset()），避免累积引用 - 若只需某几列，传入
std::vector<int> column_indices给ReadRowGroup，跳过无关列解码
性能提示：Arrow默认对STRING列使用arrow::BinaryArray，若实际全是UTF-8文本，可提前设arrow::io::IOContext的use_threads=false避免小字符串锁竞争。
处理嵌套/复杂类型（struct、list、map）的坑
Parquet支持嵌套schema，但Arrow C++对StructArray、ListArray的访问比扁平列麻烦得多。直接用table->column(i)->chunk(0)->data()拿到的是ArrayData，需手动cast：
auto array = table->column(0)->chunk(0);
if (array->type_id() == arrow::Type::STRUCT) {
auto struct_arr = std::static_pointer_cast<arrow::StructArray>(array);
auto field_arr = struct_arr->field(0); // 获取第一个子字段
}
容易踩的坑：
-
StructArray::field()返回的是std::shared_ptr<Array>，不是原始指针，别用get()裸指针操作 -
ListArray的values()返回子数组，但value_offset()才是真正的索引基址，别误用length() - Arrow 12+版本中
MapArray需通过keys()/items()双数组访问，不能当StructArray处理
嵌套字段的null值传播规则和扁平列不同，尤其在filter后重建schema时，务必检查array->null_count()是否同步更新。
