这个问题我之前也碰到过，TypeScript的声明合并特性就是解决这类本地临时扩展类型的核心！你不需要重新定义整个CodeMirror命名空间，只需要针对性扩展你需要的接口即可，具体步骤如下：

1. 创建本地类型声明文件 #

在你的项目里新建一个.d.ts类型声明文件，比如命名为codemirror-extensions.d.ts（名字随意，只要后缀是.d.ts就行），建议放在项目根目录或者src/types目录下。

2. 针对性扩展目标接口 #

在这个文件里，只需要声明你要扩展的CodeMirror子接口，TypeScript会自动把你的声明和@types/codemirror里的原有声明合并，不会覆盖整个命名空间。举个具体例子：

假设你要给CodeMirror.Editor接口的setOption方法添加一个新的重载，就这么写：

declare namespace CodeMirror {
  interface Editor {
    // 新增的函数重载：支持名为"customHighlight"的选项，值为布尔类型
    setOption(option: "customHighlight", value: boolean): void;
    // 如果还要扩展getOption的重载，也可以加在这里
    getOption(option: "customHighlight"): boolean;
  }
}

如果是要给全局的CodeMirror函数本身加重载，比如新增一个初始化参数的重载，写法类似：

declare namespace CodeMirror {
  // 扩展CodeMirror的初始化函数重载
  function fromTextArea(textarea: HTMLTextAreaElement, options: { newCustomOption: string }): Editor;
}

3. 确保声明文件被TypeScript识别 #

检查你的tsconfig.json，确保include数组包含了这个声明文件的路径。比如如果文件在项目根目录，include可以这么写：

{
  "compilerOptions": {
    // 你的原有配置
    "target": "es5",
    "module": "none"
  },
  "include": [
    "src/**/*",
    "codemirror-extensions.d.ts" // 加上这个路径
  ]
}

如果你的声明文件放在src/types目录下，也可以用"src/types/**/*.d.ts"来匹配所有类型文件。

关键注意点 #

• 绝对不要重新完整声明整个CodeMirror命名空间（比如不要写declare namespace CodeMirror { /* 所有原有接口 */ }），否则会完全覆盖@types/codemirror里的内容，这就是你之前遇到的问题。
• 只声明你需要扩展的部分，TypeScript的接口合并机制会自动把你的新声明和原有声明合并到一起。
• 确认你的.d.ts文件没有被exclude数组排除在外。

这样处理后，你本地的类型就会包含原有声明加上你新增的重载，同时不影响上游的类型包，等你反馈给上游并合并后，只需要删掉这个本地声明文件即可。

内容的提问来源于stack exchange，提问作者Clément