如何在TypeScript中优雅初始化带自定义属性的函数类型实例？

方案1：使用TS原生支持的函数与同名命名空间合并（零断言，单例场景最推荐） #

TS原生支持将同名的函数和命名空间的类型做合并，完全不需要类型断言，天然符合类型规范：

// 先定义你的基础类型
type Params = /* 替换为你的实际参数类型 */ unknown;
interface BinHex {
  (params: Params): Buffer;
  hex(params: Params): string;
}

// 定义核心函数
function compute(params: Params): Buffer {
  return Buffer.from(/* 你的业务实现 */);
}
// 定义同名命名空间，挂载附加方法
namespace compute {
  export function hex(params: Params): string {
    // 直接调用外层compute，不需要处理this指向，更安全
    return compute(params).toString('hex');
  }
}

// 自动符合BinHex类型约束，不需要任何类型转换
const binHex: BinHex = compute;

// 正常使用
compute(/* 参数 */);
compute.hex(/* 参数 */);

该方案完全符合TS语法规范，全程无类型断言，所有方法都能获得完整的类型检查，同时避免了this指向异常的问题。

方案2：封装通用构造工具（适合批量创建场景） #

如果需要批量创建多个同类型的可调用对象，可以封装一个通用的类型安全构造函数，仅在工具内部做一次安全的类型断言，对外使用全程无感知：

type CallableObject<Fn extends (...args: any[]) => any, Props extends object> = Fn & Props;

function createCallable<Fn extends (...args: any[]) => any, Props extends object>(
  fn: Fn,
  props: Props
): CallableObject<Fn, Props> {
  // 这里的断言是工具内部的安全封装，逻辑固定正确，对外无暴露
  return Object.assign(fn, props) as CallableObject<Fn, Props>;
}

// 使用时完全类型安全，不需要额外断言
const compute = createCallable(
  function (params: Params): Buffer {
    return Buffer.from(/* 业务实现 */);
  },
  {
    hex(params: Params): string {
      return compute(params).toString('hex');
    }
  }
);

// 自动适配BinHex类型
const binHex: BinHex = compute;

方案3：TS 4.9+ 使用satisfies操作符 #

如果你使用TS 4.9及以上版本，可以直接用satisfies结合Object.assign实现类型安全校验，不需要额外封装：

const compute = Object.assign(
  function (params: Params): Buffer {
    return Buffer.from(/* 业务实现 */);
  },
  {
    hex(params: Params): string {
      return compute(params).toString('hex');
    }
  }
) satisfies BinHex;

satisfies会自动校验返回值是否符合BinHex的类型约束，一旦实现不符合规范会直接抛出类型错误，同时保留完整的类型推导能力。

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