如何在TypeScript接口中定义不固定参数名的函数类型？

1. 接口参数名仅为文档提示，不强制匹配 #

TypeScript接口中定义的方法参数名只是用来做文档说明，类型检查时只会验证参数的类型、数量和顺序，完全不关心你实现或调用时用什么参数名。

比如你原来的接口：

interface IValue {
  signin(user: User, cb: (success: boolean) => void): void;
  signout(cb: () => void): void;
}

实现时可以随意自定义参数名，完全不影响类型校验：

// 实现示例：用newUser替代user，callback替代cb
const authService: IValue = {
  signin(newUser: User, callback: (success: boolean) => void) {
    console.log(`登录用户：${newUser.name}`);
    callback(true);
  },
  signout(onLogoutComplete: () => void) {
    console.log("退出登录");
    onLogoutComplete();
  }
};

调用时也可以根据上下文灵活命名，只要类型匹配即可：

const currentUser: User = { name: "张三" };
authService.signin(currentUser, (isSuccess) => {
  if (isSuccess) alert("登录成功");
});

2. 用下划线忽略未使用的参数 #

如果某个参数在实现中不需要用到，可以用下划线_作为参数名（表示“此参数未使用”），这是TypeScript社区的通用写法：

// 示例：忽略signin的user参数
const dummyAuth: IValue = {
  signin(_user: User, cb: (success: boolean) => void) {
    cb(true); // 不使用_user参数
  },
  signout(_: () => void) {
    // 完全忽略回调参数
  }
};

注意：如果有多个未使用的参数，不能重复使用_（会报重复变量名错误），可以用_user、_cb这类命名区分。

3. 进阶：对象参数提升调用灵活性（可选） #

如果希望调用时更清晰，也可以把方法参数定义成对象类型，这样调用方可以通过对象解构自定义变量名，同时保留类型检查：

// 修改接口为对象参数
interface IValue {
  signin(options: { user: User; cb: (success: boolean) => void }): void;
}

// 实现时解构自定义参数名
const authService: IValue = {
  signin({ user: currentUser, cb: onLoginSuccess }) {
    console.log(`当前登录用户：${currentUser.name}`);
    onLoginSuccess(true);
  }
};

// 调用时同样可以自定义属性名（通过对象字面量传递）
const newUser: User = { name: "李四" };
authService.signin({
  user: newUser,
  cb: (success) => console.log(success ? "登录成功" : "登录失败")
});

内容的提问来源于stack exchange，提问作者Bushuev