如何让TypeScript自定义Long类支持自动拆箱避免运算报错？

针对你开发Java转TS工具时，需要模拟Java Long自动拆箱语义的需求，以下是几种可行的方案，既能让代码正常运行，又能消除TypeScript的编译报错：

方案1：全局扩展原生类型接口 + 实现Symbol.toPrimitive #

这是最适合全局场景的方案，能让Long类和bigint/number的运算完全被TS编译器认可：

class Long {
    constructor(private value: bigint | number) {}

    // 保留运行时自动拆箱的valueOf方法
    valueOf(): bigint {
        return BigInt(this.value);
    }

    // 实现Symbol.toPrimitive，明确类型转换行为，帮助TS编译器识别
    [Symbol.toPrimitive](hint: string): bigint | string {
        return hint === 'string' ? this.value.toString() : BigInt(this.value);
    }
}

// 全局扩展BigInt和Number的运算接口，允许与Long实例进行操作
declare global {
    interface BigInt {
        +(other: Long): bigint;
        -(other: Long): bigint;
        *(other: Long): bigint;
        // 按需添加除法、取模等其他运算操作符
    }

    interface Number {
        +(other: Long): bigint;
        -(other: Long): bigint;
        *(other: Long): bigint;
    }
}

// 测试代码，无编译报错
const long = new Long(123);
console.log(456n + long); // 输出579n
console.log(789 + long); // 输出912n

方案2：局部类型断言（适合临时场景） #

如果只是局部代码需要兼容，不想全局修改类型，可以用类型断言快速绕过编译检查：

const long = new Long(123);
console.log(456n + (long as unknown as bigint)); // 编译通过

但这种方式不够优雅，不适合你的全局工具类需求。

方案3：实现虚拟BigInt接口（进阶类型兼容） #

通过让Long类实现一个模拟BigInt结构的接口，让TS编译器认为Long具备bigint的核心特性：

// 定义与BigInt核心结构匹配的接口
interface BigIntLike {
    valueOf(): bigint;
}

class Long implements BigIntLike {
    constructor(private value: bigint | number) {}

    valueOf(): bigint {
        return BigInt(this.value);
    }
}

// 扩展BigInt运算接口，允许与Long实例交互
declare global {
    interface BigInt {
        +(other: BigIntLike): bigint;
    }
}

const long = new Long(123);
console.log(456n + long); // 编译正常

原理说明 #

TypeScript编译器不会自动识别自定义类的valueOf方法来实现原生类型兼容（虽然运行时会生效）。我们需要通过以下方式让编译器认可：

1. Symbol.toPrimitive方法明确告知TS类在类型转换时的行为，增强类型推断准确性
2. 全局扩展原生类型的运算接口，允许Long实例参与bigint/number的运算
3. 实现匹配原生类型结构的接口，让TS通过结构兼容性规则认可Long与bigint的交互

这些方案完美模拟了Java中Long自动拆箱的语义，同时适配TypeScript的编译规则，适合你的Java转TS工具场景。

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