JavaScript函数参数解构是一种高效处理对象类型参数的方式，它允许我们在函数定义阶段直接对传入的对象参数进行结构拆分，将对象的属性映射为函数内部的局部变量，同时支持设置默认值、处理可选参数，非常适合需要传递多个配置项的通用函数场景。
基础参数解构用法
当函数需要接收多个参数时，我们可以将所有参数封装到一个对象中传入，然后通过参数解构直接获取需要的属性。这种方式不需要记忆参数的传递顺序，只需要知道属性名即可。
以下是一个简单的用户信息处理函数示例：
// 定义处理用户信息的函数，通过参数解构获取对象中的属性
function handleUser({ name, age, gender }) {
console.log(`姓名：${name}，年龄：${age}，性别：${gender}`);
}
// 传入包含对应属性的对象作为参数
handleUser({ name: '张三', age: 25, gender: '男' });
// 输出：姓名：张三，年龄：25，性别：男
设置参数默认值
参数解构支持为每个属性设置默认值，当传入的对象中缺少对应属性，或者属性值为undefined时，会自动使用默认值，避免函数内部出现未定义的变量错误。
修改上面的示例，为参数添加默认值：
// 为解构的属性设置默认值
function handleUser({ name = '未知用户', age = 0, gender = '未设置' } = {}) {
console.log(`姓名：${name}，年龄：${age}，性别：${gender}`);
}
// 只传入部分参数
handleUser({ name: '李四' });
// 输出：姓名：李四，年龄：0，性别：未设置
// 不传入任何参数，此时默认空对象触发解构，使用所有默认值
handleUser();
// 输出：姓名：未知用户，年龄：0，性别：未设置
这里需要注意，我们在解构的对象后面额外添加了一个{}作为默认值，这是为了避免调用函数时不传参数导致解构报错，因为无法对undefined进行解构操作。
嵌套对象参数解构
如果传入的对象包含嵌套的子对象，参数解构也支持对嵌套结构进行拆分，直接获取深层属性。
// 处理包含地址信息的用户数据，解构嵌套的address对象
function handleUserDetail({
name,
age,
address: { province, city, street } = {}
}) {
console.log(`姓名：${name}，年龄：${age}`);
console.log(`地址：${province}${city}${street}`);
}
const user = {
name: '王五',
age: 30,
address: {
province: '江苏省',
city: '南京市',
street: '中山路100号'
}
};
handleUserDetail(user);
// 输出：
// 姓名：王五，年龄：30
// 地址：江苏省南京市中山路100号
剩余参数处理
如果对象中存在不确定数量的额外属性，我们可以使用剩余运算符...将剩余的属性收集到一个新的对象中，方便后续处理。
// 收集剩余的参数到extra对象中
function handleConfig({ timeout = 3000, retry = 3, ...extra }) {
console.log(`超时时间：${timeout}ms，重试次数：${retry}`);
console.log('额外配置：', extra);
}
handleConfig({
timeout: 5000,
retry: 5,
baseURL: 'https://ipipp.com/api',
headers: { 'Content-Type': 'application/json' }
});
// 输出：
// 超时时间：5000ms，重试次数：5
// 额外配置： { baseURL: 'https://ipipp.com/api', headers: { 'Content-Type': 'application/json' } }
通用对象传递的优势
使用函数参数解构实现通用对象传递，相比传统的位置传参有以下明显优势：
- 参数顺序无关：调用函数时不需要按照定义顺序传递参数，只需要属性名匹配即可，降低参数传递的错误概率。
- 可选参数处理更灵活：通过默认值可以轻松处理可选参数，不需要在函数内部写大量的参数存在性判断逻辑。
- 代码可读性更高：函数定义处就能清晰看到需要接收的所有参数及其默认值，调用处也能直观看到每个参数的含义。
- 扩展性强：后续需要新增参数时，只需要在解构对象中添加对应的属性即可，不会影响已有的函数调用逻辑。
注意事项
在使用参数解构时，需要注意以下几点：
- 如果函数的参数可能不是对象，或者可能不传参，一定要给解构的对象设置默认值为
{}，避免解构undefined报错。 - 解构时设置的默认值只有在属性值为undefined时才会生效，如果属性值为null、空字符串等 falsy 值，不会触发默认值。
- 剩余参数必须放在解构对象的最末尾，否则会语法报错。
函数参数解构是JavaScript中处理多参数场景的实用技巧，合理运用可以大幅提升代码的健壮性和可维护性，尤其适合封装通用工具函数、组件配置函数等场景。
JavaScript函数参数解构对象传递参数默认值修改时间：2026-07-06 23:12:24