无需类型断言，能否为TypeScript接口函数设置模块私有参数？

不需要类型断言就能实现你要的效果，核心思路是把函数的内部实现和对外暴露的类型分开：

1. 定义模块内可见的内部函数，支持你需要的全部参数类型（string | number）
2. 导出时将该函数约束为对外暴露的类型（仅string参数）
3. 模块内部直接调用内部函数，无需任何断言

代码示例：

// 模块内部函数，支持string和number类型参数
function internalPublicFunction1(foo: string | number): string {
  return "abc";
}

// 导出的公共接口
export interface PublicInterface {
  publicFunction1: (foo: string) => string;
  publicFunction2: () => string;
}

// 实现并导出，内部调用内部函数
export const implementation: PublicInterface = {
  publicFunction1: internalPublicFunction1,
  publicFunction2: function(): string {
    return internalPublicFunction1(123); // 模块内调用无类型问题
  },
};

// 外部文件调用
implementation.publicFunction1("xyz"); // 正常通过类型检查
implementation.publicFunction1(123); // 类型报错，符合预期

为什么这个方案可行？ #

因为TypeScript允许将更宽泛的函数类型（支持string | number）赋值给更严格的函数类型（仅支持string），这是函数类型的逆变特性导致的安全赋值，不需要任何类型断言。模块内部直接使用未被约束的内部函数，自然支持所有参数类型；外部只能看到被约束后的导出类型，无法传入number参数。

替代方案：使用内部扩展接口（无断言） #

如果你更倾向于用接口管理类型，可以定义一个仅模块内可见的扩展接口，内部实现时用该接口，导出时自动兼容公共接口：

// 公共导出接口
export interface PublicInterface {
  publicFunction1: (foo: string) => string;
  publicFunction2: () => string;
}

// 模块内私有扩展接口，支持更多参数类型
interface InternalInterface extends PublicInterface {
  publicFunction1: (foo: string | number) => string;
}

// 内部用InternalInterface类型定义实现
const internalImplementation: InternalInterface = {
  publicFunction1: (foo: string | number) => "abc",
  publicFunction2: () => internalImplementation.publicFunction1(123),
};

// 导出时直接赋值，无需断言（因为InternalInterface是PublicInterface的子类型）
export const implementation: PublicInterface = internalImplementation;

这个方案同样不需要类型断言，模块内通过internalImplementation调用时可以传入number，外部的implementation则只能传入string。

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