悠悠楠杉
网站页面
JS注解怎么标注数组类型：JS数组类型参数的注解方法与示例
11/22
![]()
js
/**
* @typedef {Object} User
* @property {string} name - 用户姓名
* @property {number} age - 用户年龄
*/
/**
* 计算用户平均年龄
* @param {User[]} users - 用户数组
* @returns {number}
*/
function calculateAverageAge(users) {
// 实现逻辑
}
此外，还有一种历史写法是使用Array.<T>格式，如{Array.<string>}，它与{string[]}等价。尽管这种语法仍然被支持，但在现代开发中已逐渐被方括号形式取代，因其更接近ES6+的数组类型表达习惯。
对于多维数组，JSDoc同样支持嵌套标注。例如，二维数字数组可以写作{number[][]}，表示“数组的数组，每一项都是数字”。这在处理矩阵或表格数据时非常有用：
js
/**
* 计算二维数组总和
* @param {number[][]} matrix - 二维数字数组
* @returns {number}
*/
function sumMatrix(matrix) {
return matrix.flat().reduce((a, b) => a + b, 0);
}
值得注意的是，JSDoc的类型注解不仅有助于开发者理解代码，还能被现代编辑器（如VS Code）识别，提供智能提示、自动补全和错误检查功能。这意味着即使不使用TypeScript，也能享受到一定程度的类型安全。
综上所述，在JavaScript中正确标注数组类型并非难事，关键在于选择合适的语法并保持一致性。优先使用{T[]}形式标注数组元素类型，结合@typedef管理复杂结构，不仅能提升代码质量，还能显著增强团队协作效率。掌握这些技巧，将使你的JavaScript项目更加健壮和易于维护。
