本文详解 JavaScript 中二维数组（矩阵）的常见声明错误，重点解决因初始化不当导致的 TypeError: Cannot set properties of undefined 问题，并提供安全、可扩展的初始化与动态赋值方案。
本文详解 javascript 中二维数组（矩阵）的常见声明错误，重点解决因初始化不当导致的 `typeerror: cannot set properties of undefined` 问题，并提供安全、可扩展的初始化与动态赋值方案。
在 JavaScript 中模拟二维数组时，一个高频陷阱是误用 let sortedPieces = [[]] 这类“伪二维”初始化方式。该写法仅创建了一个包含单个空数组的一维数组：sortedPieces.length === 1，因此 sortedPieces[1] 为 undefined。当执行 sortedPieces[1][0] = [1,2] 时，引擎试图向 undefined 设置属性 '0'，自然抛出 TypeError: Cannot set properties of undefined (setting '0')。
根本原因在于：JavaScript 并无原生二维数组类型，所有“矩阵”都是数组的嵌套（即数组的元素本身是数组）。因此，每一级子数组都必须显式创建并赋值。
✅ 正确做法是分步初始化：
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
// 方案 1：先声明空数组，再按需 push 子数组（推荐用于动态构建）
let sortedPieces = [];
// 确保第 1 行（索引为 1）存在
if (!sortedPieces[1]) sortedPieces[1] = [];
sortedPieces[1][0] = [1, 2]; // ✅ 成功
// 方案 2：预分配指定行数（适合已知维度场景）
const rows = 3;
let sortedPieces = Array.from({ length: rows }, () => []);
sortedPieces[1][0] = [1, 2]; // ✅ 成功
// 方案 3：使用函数封装安全写入逻辑
function setMatrixCell(matrix, row, col, value) {
if (!Array.isArray(matrix[row])) {
matrix[row] = [];
}
matrix[row][col] = value;
}
setMatrixCell(sortedPieces, 1, 0, [1, 2]); // ✅ 安全且可复用⚠️ 注意事项：
立即学习“Java免费学习笔记（深入）”；
- 避免
let arr = [[]]或let arr = new Array(3).fill([])—— 后者会使所有行引用同一子数组，造成意外的数据污染； - 动态扩展时优先使用
push()或Array.from()，而非依赖稀疏索引赋值； - 若需频繁行列操作，建议封装为 Matrix 类或使用成熟库（如 math.js）。
总结：JavaScript 矩阵的核心原则是「显式初始化每一维」。从 let sortedPieces = [] 开始，按需构造子数组，即可彻底规避 undefined 赋值错误，实现健壮的多维数据管理。
