本文详解如何安全继承 decimal.js 的 Decimal 类，解决因库内部强制重写 constructor 属性导致的子类方法调用失效问题，并提供可落地的 SafeDecimal 封装方案。
本文详解如何安全继承 `decimal.js` 的 `decimal` 类，解决因库内部强制重写 `constructor` 属性导致的子类方法调用失效问题，并提供可落地的 `safedecimal` 封装方案。
在使用 decimal.js 进行高精度计算时，开发者常需对输入值进行预校验或标准化（如过滤非法字符串、拒绝模糊数字格式），以增强系统鲁棒性。直接继承 Decimal 类看似可行，但实际会遇到一个关键陷阱：decimal.js 在实例化后主动将 instance.constructor 强制设为 Decimal 构造函数本身（见源码 decimal.mjs 第 4290 行），而非保留原型链上的真实子类构造器。
这意味着：
class SafeDecimal extends Decimal {
constructor(value: Decimal.Value) {
if (typeof value === 'string') {
// ❌ 错误示例：parseFloat 允许截断式解析，如 "123abc" → 123
super(parseFloat(value));
} else {
super(value);
}
}
}
当调用 (new SafeDecimal('10')).add('invalid') 时，add() 方法内部执行 new this.constructor('invalid') —— 此时 this.constructor 已被 decimal.js 改为 Decimal，导致 'invalid' 直接传入原生 Decimal 构造器，绕过你的校验逻辑，最终抛出 DecimalError。
✅ 正确解决方案：手动恢复 constructor 引用
必须在 super() 后显式重置 this.constructor，使其指向子类自身：
import { Decimal } from 'decimal.js';
class SafeDecimal extends Decimal {
constructor(value: Decimal.Value) {
// ✅ 安全输入校验：严格匹配数字字符串格式
const sanitized = typeof value === 'string'
? /^\s*-?\d+(\.\d+)?\s*$/.test(value)
? value.trim()
: 'NaN' // 或 throw new Error('Invalid numeric string')
: value;
super(sanitized);
// ? 关键修复：覆盖 decimal.js 强制设置的 constructor
this.constructor = SafeDecimal;
}
}
// ✅ 验证通过
console.log(new SafeDecimal('123').add('invalid').toString()); // "NaN"
console.log(new SafeDecimal('10').multiply(2).toString()); // "20"
? 原理说明：decimal.js 修改 constructor 是为避免继承链中 constructor 指向 Object（历史兼容性设计）。但该行为破坏了标准 ES6 类继承语义。显式赋值 this.constructor = SafeDecimal 是唯一可靠补救方式。
⚠️ 注意事项与最佳实践
- 避免 parseFloat：它对 "123abc" 返回 123，违背“严格校验”初衷。推荐使用正则校验（如上例）或 Number(value) + isNaN() 组合，并结合 value === '' 等边界判断。
- 全局精度配置仍生效：SafeDecimal 继承 Decimal 的所有静态方法（如 Decimal.set({ precision: 50 })），无需额外适配。
- 类型安全提示：若使用 TypeScript，建议扩展 Decimal 的声明，为 SafeDecimal 添加专属类型定义，避免 .d 或 .e 等私有属性访问报错。
- 生产环境建议：对关键金融场景，更推荐在业务层统一做输入预处理（如 parseSafeDecimal(input) 工厂函数），而非继承——既规避底层库限制，又保持职责清晰。
通过这一修复，SafeDecimal 不仅能安全初始化，其所有实例方法（plus, times, pow, toFixed 等）均会正确使用你定义的构造逻辑，真正实现“一次封装，全程受控”的高精度计算保障。
