TS2451报错：未重复声明却提示块级作用域变量重复声明

这个错误的核心原因是TypeScript把你的package-list.ts文件当作全局脚本（Script）而非模块（Module）处理了。在脚本模式下，顶层变量会被挂载到全局作用域，哪怕你只声明了一次，只要TS认为这个变量可能在全局范围内重复，就会抛出这个错误。下面是几种可行的解决方案：

方案1：改用ES模块导出语法（推荐） #

TypeScript对ES模块的识别更直接，只要文件包含顶级的export或import语句，就会被当作模块处理，变量会被限制在模块作用域内，不会污染全局。修改你的代码如下：

export const packageList = { 
  'FREE': 'free', 
  'GOLD': 'gold', 
  'SILVER': 'silver', 
  'BRONZE': 'bronze', 
  'STARTER': 'starter' 
};

如果你需要默认导出，也可以写成：

const packageList = { 
  'FREE': 'free', 
  'GOLD': 'gold', 
  'SILVER': 'silver', 
  'BRONZE': 'bronze', 
  'STARTER': 'starter' 
};

export default packageList;

方案2：保留CommonJS导出，强制标记文件为模块 #

如果你坚持使用module.exports，可以在文件末尾添加一个空的ES导出语句，让TypeScript明确将其识别为模块：

const packageList = { 
  'FREE': 'free', 
  'GOLD': 'gold', 
  'SILVER': 'silver', 
  'BRONZE': 'bronze', 
  'STARTER': 'starter' 
};

module.exports = packageList;

// 添加这一行，强制TS将文件视为模块
export {};

这行空导出不会影响你的CommonJS导出逻辑，但会告诉TS：这个文件是一个模块，所有顶层变量都是模块私有的。

方案3：检查编译选项的模块设置 #

虽然你已经设置了"module": "commonjs"，但可以确认一下moduleResolution是否为node（默认值就是node，一般不需要修改），确保TypeScript能正确解析CommonJS模块。如果你的tsconfig.json里没显式设置，添加这一行：

"moduleResolution": "node"

额外排查点 #

如果以上方案都无效，检查项目中是否有其他文件（比如其他.ts或.js文件）也定义了名为packageList的全局变量——即使你没在当前文件重复声明，全局作用域的同名变量也会触发这个错误。

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