TypeScript报错：无法重新声明块级作用域变量'name'

错误本质 #

• 这个错误和node_modules无关，lib.dom.d.ts是TypeScript自带的全局类型声明文件，不属于第三方依赖内容。
• 在浏览器DOM环境的全局作用域中，name是内置全局变量（用于标识窗口名称），当TypeScript项目默认启用DOM库时，这个变量的类型会被自动注入全局作用域。
• 你在全局作用域直接声明const name: string = 'test'，会和内置的name变量声明产生命名冲突，触发TS2451错误。

解决方法 #

• 隔离到局部作用域：把代码放到函数或模块内部，避免污染全局作用域：

  function init() {
    const name: string = 'test';
    console.log(name);
  }
  init();
  

  或者给文件添加export/import语句，将其转为ES模块，自动隔离作用域：

  export const name: string = 'test';
  // 空导出也可以：export {};
  

• 移除DOM库依赖：如果你的项目是Node.js环境，不需要DOM相关类型，修改tsconfig.json的lib配置，去掉dom：

  {
    "compilerOptions": {
      "lib": ["ESNext"] // 可根据需求替换为ES2020、ES2019等版本
    }
  }
  

• 重命名变量：直接给变量换个不冲突的名字，比如userName：

  const userName: string = 'test';
  

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