函数重载技术文档

JavaScript 函数重载实现

JavaScript 没有原生的函数重载，但可以用闭包 + 链式回溯优雅地模拟它。

---

什么是函数重载

函数重载是指同一个函数名，根据传入参数的个数或类型，执行不同的逻辑。

Java、C++ 等语言原生支持，但 JavaScript 不支持——同名函数后者会直接覆盖前者。

// JavaScript 里这样写，后面的会覆盖前面的
function find() { console.log('查找所有') }
function find(name) { console.log('按名字查找') }  // ← 覆盖了上面

find()     // '按名字查找'（错误！）
find('a')  // '按名字查找'

---

核心实现

通过高阶函数 + 闭包，构建一条"方法链"，调用时按参数个数从链中匹配：

function addMethod(object, name, fn) {
  const old = object[name]  // 保存上一个版本的同名方法

  object[name] = function(...args) {
    if (args.length === fn.length) {
      // 参数个数匹配，执行当前版本
      return fn.apply(this, args)
    } else if (typeof old === 'function') {
      // 不匹配，回溯到上一个版本继续查找
      return old.apply(this, args)
    }
  }
}

---

工作原理

每次调用 addMethod，都会把新函数挂上去，同时用闭包记住旧函数：

第一次 addMethod → search.find = fn0（0个参数）
第二次 addMethod → search.find = fn1（1个参数），fn1 的 old = fn0
第三次 addMethod → search.find = fn2（2个参数），fn2 的 old = fn1

调用 search.find('Alice')：
  fn2 → 参数不匹配 → 回溯 fn1 → 参数匹配 → 执行 fn1

形成一条从新到旧的回溯链，直到参数个数匹配为止。

---

使用示例

const search = {}

addMethod(search, 'find', function() {
  console.log('查找所有记录')
})

addMethod(search, 'find', function(name) {
  console.log(`按名称查找: ${name}`)
})

addMethod(search, 'find', function(name, age) {
  console.log(`按名称和年龄查找: ${name}, ${age}`)
})

search.find()             // 查找所有记录
search.find('Alice')      // 按名称查找: Alice
search.find('Bob', 25)    // 按名称和年龄查找: Bob, 25

---

实际应用场景

const validator = {}

// 验证邮箱（1个参数）
addMethod(validator, 'validate', function(email) {
  return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)
})

// 验证密码（2个参数）
addMethod(validator, 'validate', function(password, minLength) {
  return password.length >= minLength
    && /[A-Z]/.test(password)
    && /[0-9]/.test(password)
})

validator.validate('test@example.com')   // → true/false（走邮箱验证）
validator.validate('Password123', 8)     // → true/false（走密码验证）

---

参数匹配规则

调用参数个数	处理方式
与当前函数 fn.length 完全匹配	直接执行
不匹配	回溯到上一个版本继续判断
所有版本都不匹配	无操作（可扩展为抛出错误）

---

技术关键点

fn.length 是什么？

函数的 length 属性表示声明时的形参个数（不含默认参数和 rest 参数）：

function fn(a, b, c) {}
console.log(fn.length)  // 3

这正是用来区分不同重载版本的依据。

为什么用闭包？

每次 addMethod 调用都创建了一个新的执行环境，old 变量被闭包捕获，不会被垃圾回收，保证回溯链一直存在。

---

局限性

局限	说明
只能按参数个数区分	无法按参数类型区分（如 string vs number）
调用有额外开销	每次调用会沿链回溯，不适合高频调用
闭包占内存	链越长，保留的闭包越多

---

什么时候用

✅ 适合：API 设计灵活、参数个数有明确业务含义的场景（如 find()、find(name)、find(name, age)）

❌ 不适合：高频调用的性能敏感场景，或只是简单的参数默认值场景（用 参数 = 默认值 更直接）

---

一句话总结

JavaScript 函数重载的本质是：用闭包把多个版本的函数串成一条链，调用时按参数个数从最新版本依次回溯匹配，找到就执行。