如何编写TypeScript声明文件，避免第三方库污染全局String类型？

要实现仅在导入target-library后才让TypeScript识别String的扩展方法，你需要编写模块级的全局声明，同时确保声明文件不会被TypeScript自动全局加载。

正确的声明文件写法 #

// types/target-library.d.ts
declare module 'target-library' {
  declare global {
    interface String {
      someMethod: () => null;
    }
  }

  // 空导出，标记文件为模块，避免自动全局加载
  export {};
}

关键注意事项 #

• 必须添加空导出：export {}会让这个声明文件被视为ES模块，而非全局脚本。TypeScript只会在你显式导入import 'target-library'时，才会加载这个模块并应用其中的全局类型扩展。
• 检查tsconfig配置：如果你的tsconfig.json中存在types数组，确保不要将target-library加入其中。一旦加入，TypeScript会自动加载该类型文件，导致扩展全局生效，无论是否导入库。

验证效果 #

• 未导入target-library时：'test'.someMethod会被TypeScript标记为不存在的方法。
• 导入import 'target-library'后：TypeScript会识别String.prototype.someMethod，不再报错。

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