安装@types/node后执行tsc出现URL和URLSearchParams重复标识符错误

我之前也踩过这个坑！当你在项目里安装了@types/node后执行tsc出现这种重复标识符错误，本质是TypeScript自带的标准库类型声明和**@types/node里的类型声明**撞车了——Node.js的类型包会把URL、URLSearchParams这些原本属于浏览器标准的对象也做了定义，而TS内置的lib.es2016.full.d.ts（或其他ES版本的lib文件）里已经有这些对象的声明，两者冲突就抛出了TS2300错误。

你遇到的具体错误提示如下：

../../../../../.nvm/versions/node/v10.0.0/lib/node_modules/typescript/lib/lib.es2016.full.d.ts(13404,11): error TS2300: Duplicate identifier 'URL'.

下面给你几个靠谱的解决办法，按需选择：

方法一：精准配置tsconfig.json的lib字段 #

如果你的项目是纯Node.js项目，不需要浏览器端的DOM相关标准库，直接在tsconfig.json里明确指定需要加载的ES标准库，避免加载包含浏览器类型的lib：

{
  "compilerOptions": {
    "lib": ["es2017"], // 根据你的项目需要选择合适的ES版本，比如es2020、esnext等
    // 其他配置...
  }
}

这样TS就只会加载你指定的ES标准库，不会加载包含URL声明的DOM相关lib，自然就不会冲突了。

方法二：指定只加载@types/node的类型 #

在tsconfig.json里添加types字段，告诉TypeScript只加载@types/node的类型定义，忽略其他默认的类型：

{
  "compilerOptions": {
    "types": ["node"],
    // 其他配置...
  }
}

这个方法适合纯Node项目，如果你的项目同时包含浏览器端代码，可能会导致浏览器相关类型缺失，谨慎使用。

方法三：统一全局与本地TypeScript版本 #

有时候全局安装的TS版本和项目本地依赖的TS版本不一致，也可能引发这类奇怪的类型冲突。建议在项目本地安装TypeScript：

npm install typescript --save-dev

之后用本地的tsc命令执行编译：

npx tsc

这样能确保使用的TS版本和项目依赖的@types/node版本兼容。

内容的提问来源于stack exchange，提问作者Get Off My Lawn