TypeScript的index.d.ts中新增String原型方法报ambient contexts错误原因是什么

两个报错的核心诱因是你将运行时代码和类型声明混写在了.d.ts类型声明文件中：
.d.ts是TypeScript专属的纯类型声明文件，属于「声明上下文（ambient contexts）」，这类文件仅允许存放类型相关的定义代码，不允许出现任何可执行的运行时语句、也不允许出现函数的具体实现逻辑。

两个报错的对应说明 #

• 针对Statements are not allowed in ambient contexts.报错：
  你在.d.ts中编写的String.prototype.capitalize = function () {}属于运行时赋值语句，会在代码实际执行时修改字符串原型，这类可执行语句不允许出现在声明上下文中，因此触发报错。
• 针对An implementation cannot be declared in ambient contexts.报错：
  你给capitalize方法编写了完整的函数实现逻辑，声明上下文仅支持定义方法的类型签名，不支持写具体的实现代码，因此触发报错。

1. 保留index.d.ts中的纯类型声明代码，删掉运行时实现部分：

export {};

declare global {
  interface String {
    capitalize(): string;
  }
}

这部分代码的作用是给TypeScript补充类型提示，告知编译器String原型上存在capitalize方法，以及该方法的参数、返回值类型。

2. 将原型方法的实现代码挪到普通的.ts业务文件中（比如项目入口文件index.ts或者全局工具初始化文件）：

String.prototype.capitalize = function () {
  return this.charAt(0).toUpperCase() + this.slice(1);
};

注意要保证这个.ts文件会在你调用capitalize方法之前被加载执行，才能让原型扩展生效。

内容的提问来源于stack exchange，提问作者anonymous-dev