如何在typescript中解决 error TS2451: Cannot redeclare block-scoped variable 'name'
问题
昨天用 Typescript
从零搭建一个 nodeJS
项目时, 遇到一个声明常量 name
的报错。代码如下:
1 const name = 'youthcity'; 2 3 function greeter(name:string) { 4 return `Hello ${name}`; 5 } 6 7 console.log(greeter(name));
console.log(greeter(name));
一个不到8行的代码,IDE却报了一个错误。明明与其他文件没有相互依赖,却会提示 [ts] 无法重新声明块范围变量“name”。
。且该文件目录夹下,也没有其他文件。为什么会有这个报错呢?ㄟ( ▔, ▔ )ㄏ

原因
在默认状态下,typescript
将 DOM typings
作为全局的运行环境,所以当我们声明 name
时, 与 DOM
中的全局 window
对象下的 name
属性出现了重名。因此,报了 error TS2451: Cannot redeclare block-scoped variable 'name'.
错误。
解决方法
解决这个问题,思路有两个:
方法一
将运行环境由 DOM typings
更改成其他运行环境。
我们可以在 tsconfig.json
中做一下声明:
1 { 2 "compilerOptions": { 3 "lib": [ 4 "es2015" 5 ] 6 } 7 }
方法二
既然与全局的变量出现重名,那我们将脚本封装到模块(module)内。module
有自己的作用域,自然不会与全局作用域的变量产生冲突。
在 Typescript 中,只要文件存在 import 或 export 关键字,都被视为 module
1 const name = 'youthcity'; 2 3 function greeter(name:string) { 4 return `Hello ${name}`; 5 } 6 7 8 console.log(greeter(name)); 9 10 export {};
我们在脚本的最后一行,添加了
export {};
。将文件声明为 module, 变量 name
被限制在了 module 的作用域下,因此不会与全局的name产生冲突。
分类:
ts
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
· AI与.NET技术实操系列:向量存储与相似性搜索在 .NET 中的实现
· 基于Microsoft.Extensions.AI核心库实现RAG应用
· Linux系列:如何用heaptrack跟踪.NET程序的非托管内存泄露
· 开发者必知的日志记录最佳实践
· TypeScript + Deepseek 打造卜卦网站:技术与玄学的结合
· Manus的开源复刻OpenManus初探
· AI 智能体引爆开源社区「GitHub 热点速览」
· C#/.NET/.NET Core技术前沿周刊 | 第 29 期(2025年3.1-3.9)
· 从HTTP原因短语缺失研究HTTP/2和HTTP/3的设计差异