为何本地TypeScript环境无法为String.prototype添加新方法？

这其实是TypeScript对模块和全局脚本的处理逻辑不同导致的：

• 当你的文件里没有任何import或export语句时，它会被当作全局脚本——此时你声明的interface String会直接和全局的String接口合并，TypeScript能识别到你扩展了原生String类型，所以不会报错。
• 一旦你加入了import（比如import * as path from 'path'），这个文件就变成了模块。模块里的所有声明默认都是局部作用域的，你此时声明的interface String只在当前模块内部有效，不会影响全局的String类型。所以当你给String.prototype加方法时，TypeScript会提示全局String类型没有这个属性。

方法一：用declare global在模块里扩展全局类型 #

直接在当前模块文件里，把接口扩展包裹在declare global块里，明确告诉TypeScript你要修改全局类型：

import * as path from 'path';

// 扩展全局String接口
declare global {
  interface String {
    newMethod(): void;
  }
}

// 实现原型方法
String.prototype.newMethod = function() {
  // 这里写你的方法逻辑，比如：
  console.log('这是我给String加的新方法！');
};

方法二：单独创建全局类型声明文件 #

如果你的项目里有多个地方需要扩展原生类型，更规范的做法是单独建一个类型声明文件：

1. 在src目录下新建types/string-extensions.d.ts文件，内容如下：

// src/types/string-extensions.d.ts
interface String {
  newMethod(): void;
}

2. 确保你的tsconfig.json能识别到这个类型文件，调整配置：

{
  "compilerOptions": {
    "target": "es2015",
    "module": "commonjs",
    "outDir": "./lib",
    "rootDir": "./src",
    "typeRoots": ["./node_modules/@types", "./src/types"] // 加入自定义类型目录
  },
  "include": ["src/**/*"] // 确保包含所有src下的文件
}

3. 之后在任意模块文件里直接实现原型方法即可：

import * as path from 'path';

String.prototype.newMethod = function() {
  // 你的实现代码
};

扩展原生类型时，尽量选不会和未来ECMAScript标准冲突的方法名，避免以后升级TS或JS时出现兼容性问题~

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