最安全常用的手动展平方式是用 std::vector 按行优先遍历二维数组并 push_back，需提前 reserve、确保行列顺序正确、避免指针强制转换误用于非连续内存结构。
用 std::vector 手动展平最安全、最常用
直接操作原始二维数组容易越界或搞错内存布局，std::vector 能自动管理内存，也方便后续传参或迭代。展平本质就是按行优先（C 风格）把每个元素依次 push 进新 vector。
常见错误是把列数写反、漏掉内层循环变量，或者误用 data() 指针导致浅拷贝。
- 确认原数组维度：比如
int arr[3][4]是 3 行 × 4 列，展平后应为 12 个元素 - 目标 vector 大小提前 reserve：避免多次 realloc，
v.reserve(rows * cols) - 遍历顺序必须是外层行、内层列，否则逻辑错乱（如图像处理中行列颠倒会翻转图像）
示例：
int arr[3][4] = {{1,2,3,4}, {5,6,7,8}, {9,10,11,12}};
std::vector<int> flat;
flat.reserve(3 * 4);
for (int i = 0; i < 3; ++i)
for (int j = 0; j < 4; ++j)
flat.push_back(arr[i][j]);
// flat == {1,2,3,4,5,6,7,8,9,10,11,12}
用指针强制转换只适用于连续内存的静态数组
像 int arr[3][4] 这种栈上定义的二维数组，内存是连续的，可以用 reinterpret_cast 或取首地址转成一维指针。但前提是：类型匹配、无 padding、且不能用于 std::array<std::array<int, 4>, 3> 这类嵌套对象（它们内部是对象，不是纯数据块）。
立即学习“C++免费学习笔记（深入）”；
典型错误是把 &arr[0][0] 写成 &arr[0]，后者是指向数组的指针，类型是 int(*)[4]，强转后访问会越界。
- 正确做法：
int* p = &arr[0][0];—— 得到指向第一个 int 的指针 - 访问第
i行第j列：等价于p[i * 4 + j]，其中4是列数（第二维大小） - 不能对
std::vector<std::vector<int>>做这种转换：内存不连续，行为未定义
处理 std::vector<std::vector<int>> 必须逐层拷贝
这是最常踩坑的场景：很多人以为 vec2d[0].data() 拼起来就行，但每个子 vector 的内存是独立分配的，强行拼接指针会崩溃或读垃圾值。
性能影响明显——如果子 vector 数量多、每行很短，频繁 push_back 会导致多次小内存分配；可先算总长度再 reserve。
- 先遍历外层 vector 累加 size：
size_t total = 0; for (const auto& row : vec2d) total += row.size(); - 初始化 flat vector：
std::vector<int> flat; flat.reserve(total); - 再嵌套循环：
for (const auto& row : vec2d) for (int x : row) flat.push_back(x); - 别用
insert配begin/end：语法啰嗦，没优势
展平后访问原坐标要小心算偏移
展平不是为了丢掉结构信息，而是为了适配某些 API（如 OpenGL 纹理上传、Eigen 矩阵构造）。所以你很可能需要把 (i,j) 映射回一维索引。
核心公式是 index = i * cols + j，但「cols」必须是原始二维结构的列数，不是运行时某一行的 .size()（尤其对 ragged array 不适用）。
- 如果原结构不规则（每行长度不同），就不能用单一 cols，必须保留行偏移表或改用索引向量
- 行列顺序不能反：
i * rows + j是错的，会导致所有数据错位 - 用
size_t计算偏移，避免有符号/无符号混用警告
展平本身很简单，难的是后续怎么用、边界怎么控、内存模型是否真连续——这些地方一疏忽，调试半小时都找不到根因。
