Arrow C++ 最小编译需链接 libarrow 并用 find_package(Arrow REQUIRED)；CSV 读取须显式指定 column_types 避免类型推断；Compute API 实现零拷贝向量化计算；注意 Buffer/Array 生命周期，禁用裸指针访问内存。
Arrow C++ 库的最小可行编译配置
Arrow C++ 不是头文件库，必须链接预编译的 libarrow（或启用 ARROW_STATIC 静态链接）。直接 #include "arrow/api.h" 但不链接会报 undefined reference to arrow::Array::MakeFromScalar 类错误。
- 用 CMake 时必须调用
find_package(Arrow REQUIRED)，且确保ARROW_BUILD_SHARED=ON（默认）与你的构建类型一致 - macOS 上若用 Homebrew 安装，需额外设置
set(ARROW_HOME /opt/homebrew/opt/apache-arrow)并在find_package前加set(CMAKE_PREFIX_PATH ${ARROW_HOME}) - Windows + MSVC 下注意运行时一致性：Arrow 若用
/MD编译，你的项目也必须用/MD，否则std::shared_ptr跨 DLL 边界析构崩溃
从 CSV 构建 Arrow Table 的高效写法
别用 arrow::csv::ReadCSV 默认参数读大文件——它默认把所有列当 string 推断，内存暴涨且后续类型转换开销大。必须显式传 arrow::csv::ConvertOptions 指定 schema。
auto convert_options = arrow::csv::ConvertOptions::Defaults();
convert_options.column_types = {
{"ts", arrow::timestamp(arrow::TimeUnit::MICRO)},
{"value", arrow::float64()},
{"category", arrow::dictionary(arrow::int32(), arrow::utf8())}
};
auto read_options = arrow::csv::ReadOptions::Defaults();
auto parse_options = arrow::csv::ParseOptions::Defaults();
auto table = arrow::csv::ReadCSV("data.csv", read_options, parse_options, convert_options).ValueOrDie();
-
column_types提前指定能跳过类型推断，减少内存驻留时间 - 对高基数字符串列，优先用
dictionary类型，压缩率常达 5–10× - 避免
ReadCSV(...)->ToTable()两步走，ReadCSV返回就是Table，多调一次ToTable白拷贝
用 Compute API 做列式过滤和聚合（不用手写循环）
Arrow 的 arrow::compute::Filter 和 arrow::compute::Sum 是零拷贝、向量化、自动 SIMD 的。手写 for-loop 遍历 Array 数据不仅慢，还绕过内存对齐优化。
auto arr = table->GetColumnByName("value")->chunk(0);
auto predicate = arrow::compute::Less(arr, arrow::compute::ScalarConstant(100.0));
auto filtered = arrow::compute::Filter(arr, predicate.ValueOrDie()).ValueOrDie();
auto sum = arrow::compute::Sum(filtered).ValueOrDie();
std::cout << *sum.scalar_as<arrow::DoubleScalar>().value << "\n";
-
chunk(0)只取首 chunk——实际数据可能分 chunk 存储，批量处理要用table->column(i)->chunks()循环 -
Filter返回新Array，不是视图；如需原地过滤，得用arrow::compute::Take+ 索引数组 - 聚合函数（
Sum/Mean）默认返回Scalar，但GroupBy尚未稳定（截至 Arrow 15.x），复杂分组仍需导出到 Pandas 或用arrow::dataset
内存生命周期和零拷贝导出的关键陷阱
arrow::Buffer 和 arrow::Array 共享底层 arrow::MemoryPool 分配的内存，但它们的 std::shared_ptr 生命周期独立。常见错误是提前释放 Table，却还在用其 Array 的 data() 指针。
立即学习“C++免费学习笔记（深入）”；
- 永远不要保存
array->data()->buffers[1]->data()这类裸指针——它没所有权，Array析构后就悬空 - 需要长期持有数据？用
arrow::Buffer::Copy或构造新arrow::Array显式复制 - 导出到 NumPy：用
arrow::py::ImportArray（Python 绑定），C++ 侧别自己 memcpy 到PyArrayObject——类型/字节序/对齐全得手动校验，极易出错
最易被忽略的是 chunked array 的跨 chunk 边界操作——比如按行号索引第 1000000 行，你得先算清它落在哪个 chunk、偏移多少，Table::RowSlicing 尚未提供高效接口，得自己做二分查找 chunk_offsets。
