JavaScript函数签名校验需依赖外部工具，主要分静态检查（如TypeScript、JSDoc）和运行时校验两类；TS最可靠，支持参数/返回值类型、可选/剩余参数及重载；纯JS可用JSDoc+插件获提示，或手动校验但成本高、不彻底。
JavaScript 本身是动态类型语言，不支持原生的函数签名类型检查。所谓“函数签名校验”，实际依赖外部工具或运行时逻辑来实现，核心方式有两类：静态检查（开发阶段）和运行时校验（执行阶段）。
用 TypeScript 做静态签名检查
TypeScript 是最主流、最可靠的方案。它在编译期检查参数数量、类型、顺序及返回值，完全覆盖函数签名语义。
- 定义函数时直接标注参数类型和返回类型：const add = (a: number, b: number): number => a + b;
- 调用时若传入字符串或缺参数，TS 编译器立刻报错，IDE 也能实时提示
- 支持复杂签名：可选参数（b?: number）、剩余参数（...nums: number[]）、重载声明等
- 搭配 JSDoc + // @ts-check 可在纯 JS 文件中启用轻量级类型检查
运行时手动校验函数参数
适合无法使用 TS 的场景（如纯 JS 项目或需要动态兼容性），但需自行编写校验逻辑，成本高且易遗漏。
- 检查 arguments.length 或解构后的参数是否为 undefined
- 用 typeof、Array.isArray()、instanceof 等判断类型
- 封装通用校验工具函数，例如：validateSignature(fn, [Number, Number], Number)
- 注意：运行时校验无法捕获调用前的错误，仅能抛出异常或降级处理，影响性能且不够直观
利用 JSDoc + 类型工具辅助检查
在 JS 文件中写 JSDoc 注释，配合 VS Code 和 ESLint 插件（如 eslint-plugin-jsdoc），能获得近似 TS 的提示能力。
立即学习“Java免费学习笔记（深入）”；
- 示例注释：/** @param {number} a @param {string} b @returns {boolean} */
- VS Code 能据此推断类型并提示参数错误，但不强制，也不校验运行时值
- 适合渐进式迁移或小型项目，不能替代 TS 的完整性保障
避免常见误区
函数签名校验不是“加个 if 判断就行”，关键在一致性与可维护性。
- 不要只校验参数个数而忽略类型（比如把 null 当作 number 接受）
- 避免在每个函数里重复写校验逻辑，应抽象成可复用的装饰器或高阶函数
- 注意箭头函数、方法绑定、call/apply 等场景下 this 和参数传递的差异
- 第三方库（如 io-ts、zod）可用于运行时结构化校验，但通常用于对象而非函数签名本身
不复杂但容易忽略
