TypeScript装饰器编译异常：配置与命令行编译结果不一致

这个错误的核心矛盾是：你的代码是基于旧版实验性装饰器编写的（仅接收1个构造函数参数），但TypeScript在读取tsconfig时，却按照Stage 3标准装饰器的规则进行检查（标准类装饰器会传入2个参数：构造函数+上下文对象）。而命令行编译正常，是因为命令行参数强制启用了实验性装饰器模式，规避了配置冲突或生效问题。

以下是具体原因和对应解决方式：

1. tsconfig配置位置错误 #

确保"experimentalDecorators": true必须写在compilerOptions对象内部，而非配置文件根节点。错误的配置会导致该选项不生效，TypeScript默认启用标准装饰器模式。

正确的tsconfig结构示例：

{
  "compilerOptions": {
    "target": "ES5",
    "experimentalDecorators": true
  }
}

2. TypeScript版本与配置兼容性 #

从TypeScript 5.0开始，标准装饰器成为默认行为，只有显式设置experimentalDecorators: true才会启用旧版实验性装饰器。如果你的项目本地TypeScript版本是5.x，但tsconfig中该配置未正确生效，就会触发标准装饰器的参数检查逻辑。而命令行直接传递--experimentalDecorators参数会强制启用旧版模式，因此编译正常。

3. 配置继承或冲突 #

若你的tsconfig使用extends继承了其他配置文件（如社区推荐配置），父配置可能覆盖了experimentalDecorators的设置，或启用了冲突配置（如useDefineForClassFields在部分场景下会影响装饰器行为）。

可通过tsc --showConfig命令查看最终生效的编译配置，确认experimentalDecorators是否为true。

4. 命令行与本地tsc版本不一致 #

全局安装的tsc版本和项目本地node_modules中的tsc版本可能存在差异：

• 若全局tsc是4.x版本（旧版，实验性装饰器逻辑更易生效），直接运行tsc会使用全局版本，编译正常；
• 若本地tsc是5.x版本，运行npx tsc -p tsconfig.json时会使用本地版本，此时若tsconfig配置有问题就会报错。

解决方式是统一版本：通过npx tsc -v查看本地版本，tsc -v查看全局版本，必要时更新或对齐版本。

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