JavaScript 函数参数默认值怎么用，哪些情况不会生效

Felix

发布时间：2026-08-25 | 47人浏览过

原创

前言

在 JavaScript 里，函数参数默认值是处理“调用时没给参数”最直接的办法。它从 ES6 开始可用，能让函数定义本身就带上兜底规则；但它到底在什么情况下生效、遇到 null 或 0 时会不会替换、和解构参数一起用时又该怎么写，恰恰是最容易混淆的地方。下面按实际使用场景拆开说明，方便你快速判断该直接写默认值，还是改用 ?? 或显式判断。

直接在形参里写默认值

从 ES6 开始，JavaScript 可以在函数定义阶段直接给参数赋默认值，写法就是在形参后面接 =。这样函数在没有拿到对应参数时，会自动使用预设值，不需要再在函数体里手动判断。

用便签卡片展示 JavaScript 参数默认值何时生效、何时不生效 — **默认值到底在什么情况下生效**用对比卡片把“默认值只对 undefined 生效”这件事讲清楚，比单纯罗列概念更直观。

function greet(name = '游客', age = 18) {
console.log(`你好，${name}，今年${age}岁`);
}
greet(); // 你好，游客，今年18岁
greet('小明'); // 你好，小明，今年18岁
greet('小红', 25); // 你好，小红，今年25岁

这里有一个判断规则要记住：只有参数值为 undefined 时，默认值才会生效。所谓“没传参”，本质上也是该位置得到 undefined。

因此，下面这些情况要区分开看：

不传参：会触发默认值
显式传入 undefined：也会触发默认值
传入 null、0、false、空字符串：不会触发默认值，函数会直接使用传入值

这也是参数默认值和很多人熟悉的“假值兜底”写法最大的不同。默认值机制判断的是 undefined，不是广义上的 falsy 值。

默认值也可以是动态表达式

默认值不一定只能写固定字面量，它也可以是表达式、函数调用，甚至依赖外部变量。这样做的好处是，默认值不仅能“补空”，还能在函数调用时动态计算。

function createId(prefix = 'item_', suffix = Date.now()) {
return `${prefix}${suffix}`;
}
console.log(createId()); // item_171xxxxxx

function log(msg, time = new Date().toLocaleTimeString()) {
console.log(`[${time}] ${msg}`);
}

这里的关键点是：默认值表达式会在每次调用函数时重新执行，而不是函数定义时只执行一次。所以像 Date.now() 这样的表达式，每次调用拿到的结果都可能不同。

这类写法适合用于：

生成时间戳、编号、随机值等动态内容
按当前环境补充日志时间、上下文信息
根据外部变量或已有参数生成兜底值

但也要注意，既然表达式会在调用时执行，就不适合放入成本过高、带明显副作用的逻辑。默认值应当保持可预期，避免让函数签名本身变得难理解。

解构参数时，记得给整体参数一个默认值

当函数接收的是对象或数组时，默认值通常会和解构赋值一起使用。这是前端开发里很常见的一种模式，尤其适合配置项函数。

展示对象解构参数默认值两层兜底关系的编辑插画 — **对象解构里的两层默认值**对象解构时，字段默认值和整个参数的默认空对象是两层不同的保护，适合单独画出来。

function connect({ host = 'localhost', port = 3000, secure = false } = {}) {
const url = `${secure ? 'https' : 'http'}://${host}:${port}`;
console.log(url);
}
connect(); // http://localhost:3000
connect({ host: 'api.example.com', secure: true }); // https://api.example.com:3000

这段代码里其实有两层默认值：

对象内部的 host、port、secure 分别有自己的默认值
整个参数最后的 = {}，给“整个对象参数”提供了一个默认空对象

第二层尤其重要。因为如果调用时完全不传参数，函数拿到的是 undefined，这时直接解构会报错；补上 = {} 后，解构就有了安全的起点。

可以把它理解成两步：

先判断有没有传入对象，没有就先用空对象 {}
再从这个对象里解构字段，没有的字段再各自使用默认值

这种写法比在函数体里层层判断更紧凑，语义也更清楚，特别适合可选配置较多的场景。

常见误区：null 和其他 falsy 值不会触发默认值

很多人第一次接触参数默认值时，会误以为它和 || 兜底差不多，实际上两者规则不同。参数默认值只认 undefined，而 null、0、false、'' 都会被当成“用户明确传入了值”。

对比参数默认值、空值合并和显式判断的适用边界 — **默认值、?? 与手动判断怎么选**这一节最容易混淆，适合用三栏对比把默认值、?? 和显式判断的边界放在一起。

function showCount(count = 10) {
console.log(count); // 传 0 → 输出 0，不是 10
}
function showCountSafe(count) {
count = count ?? 10;
console.log(count); // 传 0 或 null → 输出 0 或 null；只对 undefined 用 10
}

这里还需要顺手澄清一个容易写错的判断思路：