Angular 启动时报 TS2393：Duplicate function implementation 怎么解决？

2026-11-04数据阿明

结论

先查找项目中是否定义了全局函数 stop，以及是否有重复的函数实现。不要直接修改 node_modules/typescript/lib/lib.dom.d.ts。

错误指向 declare function stop(): void;，说明浏览器类型声明中的 stop() 参与了冲突，但仅凭这一处报错，还无法确定冲突来自哪个文件。需要结合完整编译日志和项目代码继续定位。

lib.dom.d.ts 是 TypeScript 提供的浏览器环境类型声明文件，其中包含全局函数 stop()。

如果一个文件没有顶层 import 或 export，且 TypeScript 将它按普通脚本处理，其顶层函数就会进入全局作用域。例如：

function stop(): void {
  // 项目中的停止逻辑
}

这样的声明可能与 DOM 类型声明或其他脚本文件中的同名声明冲突。报错位置在类型声明文件中，并不意味着需要修改它。

同一作用域中有多份同名函数实现也会触发 TS2393，因此全局名称冲突和重复实现都需要检查。

在编辑器中搜索 function stop 和 stop(，重点查看没有 import、export 的工具文件、示例文件或临时脚本。

如果安装了 rg，可以在项目根目录执行：

rg -n --glob '*.{ts,js}' --glob '!node_modules/**' --glob '!dist/**' '\bstop\s*\(' .

搜索结果也会包含调用位置，需要逐项区分函数声明、函数实现和普通调用。同时查看完整编译日志，确认是否还有其他文件位置。

如果这是业务函数，通常可以换成更具体的名称，并同步修改调用位置。例如：

function stopPlayback(): void {
  // 原有停止逻辑
}

stopPlayback();

如果该文件原本就应该作为模块使用，可以通过导出函数明确其模块边界：

export function stop(): void {
  // 原有停止逻辑
}

其他文件通过 import 使用它：

import { stop } from './playback';

stop();

如果函数只需要在文件内部使用，也可以在文件顶层添加：

export {};

这样会使文件成为模块，其顶层声明不再进入全局作用域。使用前要确认该文件不依赖向全局暴露函数；如果原有代码依赖全局调用，也需要相应调整。

如果发现两个带函数体的同名函数，应删除重复实现、合并逻辑或使用不同名称。

如果本意是写 TypeScript 函数重载，可以保留多个重载签名，但只能有一个实际函数体。也要检查类中是否有重复方法，不要只搜索全局函数。

如果在当前源码中没有发现明显冲突，继续检查应用实际使用的 tsconfig 及其继承的配置，重点关注 files、include、exclude 和 allowJs。

确认临时脚本、复制出来的旧文件或生成文件是否意外参与了编译。如果启用了 allowJs，还应检查被纳入编译的 JavaScript 文件。修改后重新运行：

ng serve

如果冲突来自项目源码或编译范围，清理 npm 缓存和重新安装依赖不会改变这些声明，错误仍会出现。

也不建议通过删除 DOM 类型声明、移除 dom 配置或开启 skipLibCheck 来处理这次错误。这些操作可能影响类型检查范围，但没有消除项目中的重复声明。

仅凭现有材料，无法认定 Angular 19.2.x 与 TypeScript 5.8.3 的版本组合是错误原因。如果上述检查仍未定位问题，需要结合完整错误日志、相关函数代码和实际生效的 tsconfig，再判断是否涉及依赖或版本配置。