已设置lib为es2016，为何仍报Math.sign()不存在于Math类型？

问题背景 #

将JS代码库迁移到TS时，使用Math.sign()出现编译错误：

Property 'sign' does not exist on type 'Math'. Do you need to change your target library? Try changing the 'lib' compiler option to 'es2015' or later.

尽管tsconfig已配置target: es2016、lib: ["es2016", "dom"]，但报错依然存在。

可能原因 #

• 项目中存在多个tsconfig文件，编译器未读取到你配置的那一个
• TypeScript版本过低，对ES2015+ API的类型定义支持不完善
• lib配置被其他设置覆盖，或第三方类型声明干扰了全局Math的类型

解决步骤 #

• 确认tsconfig的有效性
  检查项目是否有多个tsconfig（如子目录的tsconfig.app.json），通过IDE右下角或编译命令tsc --project ./tsconfig.json指定配置文件，确保编译器使用的是你修改的配置。

• 升级TypeScript版本
  执行终端命令升级TS到最新稳定版：

  npm install typescript@latest --save-dev
  

  旧版本TS可能存在类型定义滞后问题，升级后通常能解决这类API类型缺失报错。

• 调整lib配置或添加兜底声明
  尝试将lib配置修改为["es2015", "es2016", "dom"]，显式包含低版本ES库补全类型覆盖；若仍无效，可在项目中新建typings.d.ts文件，添加全局类型声明：

  interface Math {
    sign(x: number): number;
  }
  

• 清除缓存
  执行VS Code命令Ctrl+Shift+P → "TypeScript: Restart TS Server"，或删除node_modules/.cache目录（如有），清除TS编译缓存。

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