如何解决MonacoEnvironment块级变量重复声明TS2451错误？

云原生阿岚

2026-8-5

问题

我开发了私有库@labcorp/ngx-monaco-editor，该库可正常构建、测试，项目运行无异常，且已成功集成到多个项目，但其中一个项目出现如下TypeScript重复声明错误：

Error: node_modules/monaco-editor/esm/vs/editor/editor.api.d.ts:12:9 - error TS2451: Cannot redeclare block-scoped variable 'MonacoEnvironment'.

12     let MonacoEnvironment: Environment | undefined;
           ~~~~~~~~~~~~~~~~~

  node_modules/monaco-editor/monaco.d.ts:11:13
    11 declare let MonacoEnvironment: monaco.Environment | undefined;
                   ~~~~~~~~~~~~~~~~~
    'MonacoEnvironment' was also declared here.


Error: node_modules/monaco-editor/monaco.d.ts:11:13 - error TS2451: Cannot redeclare block-scoped variable 'MonacoEnvironment'.

11 declare let MonacoEnvironment: monaco.Environment | undefined;
               ~~~~~~~~~~~~~~~~~

  node_modules/monaco-editor/esm/vs/editor/editor.api.d.ts:12:9
    12     let MonacoEnvironment: Environment | undefined;
               ~~~~~~~~~~~~~~~~~
    'MonacoEnvironment' was also declared here.

我已仔细检查tsconfig文件，尝试多种修改仍未找到问题根源。在Angular CLI创建的全新Angular 14项目中该库可正常工作，说明错误是项目特有的。目前唯一临时解决方法是手动注释monaco.d.ts第11行：

declare let MonacoEnvironment: monaco.Environment | undefined;

请问如何正确解决该错误？

解决方案

统一monaco-editor导入方式：确保项目只加载一份声明文件。在项目的tsconfig.json中，移除types数组里的monaco-editor，同时在exclude中添加其中一份冲突的声明文件（比如node_modules/monaco-editor/monaco.d.ts），强制使用ES模块版本的声明。
锁定依赖版本：对比正常项目和问题项目的monaco-editor版本，确保私有库与宿主项目使用完全一致的版本。可以在私有库的package.json中将monaco-editor设为peerDependencies，让宿主项目统一管理依赖，避免多版本共存。
自定义声明覆盖：在项目src目录下创建monaco-fix.d.ts文件，内容如下：
```
declare global {
  let MonacoEnvironment: monaco.Environment | undefined;
}
export {};
```
然后在tsconfig.json的include数组中添加该文件，让TypeScript优先使用此声明来覆盖冲突的定义。
临时跳过库类型检查（谨慎使用）：在tsconfig.json中设置"skipLibCheck": true，跳过第三方库的类型检查以规避错误，但此方法可能掩盖其他潜在类型问题，不建议长期使用。

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