一维数组转二维数组方法详解

本文详解如何将一维 double 类型数组按行优先（row-major）顺序转换为 m×n 的二维 double 数组，支持任意合法尺寸，并提供 JavaScript 与 Java 的完整实现及边界处理。

在科学计算、图像处理或矩阵运算中，常需将线性存储的一维 double[] 数据重新组织为二维结构（如 double[][]），以匹配算法接口或内存布局要求。核心思路是利用整数除法与取模运算，将一维索引 i 映射到二维坐标 (row, col)：

• 列索引（x 方向） = i % x（即每行容纳 x 个元素，余数决定列位置）
• 行索引（y 方向） = Math.floor(i / x)（即每 x 个元素换一行）

注意：此处 x 表示目标二维数组的列数（宽度），y 表示行数（高度）；总容量应满足 x * y ≥ oneDimArray.length，否则会越界（本文实现默认截断，实际应用中建议校验并抛出异常）。

以下为 JavaScript 实现（支持泛型推导，自动初始化零值）：

function reshape(oneDimArray, x, y) {
  if (x < 0 || y < 0) 
    throw new RangeError('x and y must not be negative');

  // 创建 y 行、每行 x 列的二维数组，初始值为 0
  const twoDimArray = Array.from({ length: y }, () => 
    Array(x).fill(0)
  );

  for (let i = 0; i < oneDimArray.length; i++) {
    const row = Math.floor(i / x);   // 行索引
    const col = i % x;               // 列索引
    if (row < y && col < x) {        // 安全写入，防止越界
      twoDimArray[row][col] = oneDimArray[i];
    }
  }
  return twoDimArray;
}

// 示例调用
const sample = [1.0, 2.0, 3.0, 4.0];
console.log(reshape(sample, 2, 2)); // [[1, 2], [3, 4]]
console.log(reshape(sample, 1, 4)); // [[1], [2], [3], [4]]
console.log(reshape(sample, 4, 1)); // [[1, 2, 3, 4]]

Java 版本需显式声明类型，并使用 Arrays.deepToString() 辅助调试：

import java.util.Arrays;

public class ArrayReshape {
    public static double[][] reshape(double[] oneDimArray, int cols, int rows) {
        if (cols < 0 || rows < 0) 
            throw new IllegalArgumentException("cols and rows must not be negative");

        double[][] result = new double[rows][cols]; // 自动初始化为 0.0

        for (int i = 0; i < oneDimArray.length; i++) {
            int row = i / cols;
            int col = i % cols;
            if (row < rows && col < cols) {
                result[row][col] = oneDimArray[i];
            }
        }
        return result;
    }

    public static void main(String[] args) {
        double[] sample = {1.0, 2.0, 3.0, 4.0};
        System.out.println(Arrays.deepToString(reshape(sample, 2, 2))); // [[1.0, 2.0], [3.0, 4.0]]
        System.out.println(Arrays.deepToString(reshape(sample, 3, 2))); // [[1.0, 2.0, 3.0], [4.0, 0.0, 0.0]]
    }
}

⚠️ 关键注意事项：

• 若 oneDimArray.length > x * y，超出部分将被忽略；若小于，则剩余位置保持初始化值（JS 中为 0，Java 中为 0.0）；
• 实际工程中建议增加校验逻辑，例如 if (oneDimArray.length != x * y) throw new IllegalArgumentException(...)；
• 该算法时间复杂度为 O(x·y)，空间复杂度同为 O(x·y)，适用于中等规模数据；
• 所有实现均遵循行主序（row-major order），即一维数组从前到后依次填充第 0 行、第 1 行……符合绝大多数数学库（如 NumPy、BLAS）的约定。

掌握此映射原理，可轻松扩展至更高维重塑（如 1D → 3D）、转置、分块等操作，是数组底层操作的重要基础。