TypeScript转译异常：let/const被转为var（已设target为ES6）

问题详情 #

tsconfig.json中已配置"target":"ES6"，但转译TypeScript文件时，用let和const声明的变量被转为var。直接在终端执行tsc命令时转译结果正常。

示例代码 #

data.ts：

const FirstName: string = "John"
let age: number = 23

转译后的data.js：

var FirstName = "John";
var age = 23;

可能的原因及解决方案 #

1. 编辑器/IDE插件使用全局tsc而非项目本地版本 #

多数编辑器（如VS Code）默认调用全局安装的TypeScript版本，若全局版本过低（不支持ES6语法转译），就会出现配置不生效的情况。

• 解决办法：
  • 在编辑器的TypeScript版本选择器中，切换到项目本地node_modules/typescript版本
  • 未安装本地TypeScript时，执行npm install typescript --save-dev完成安装

2. 转译工具未正确读取tsconfig.json #

如果用编辑器自带转译功能或第三方构建工具（Webpack、Vite等），可能存在工具未加载项目根目录tsconfig.json的情况。

• 解决办法：
  • 检查构建工具配置文件，明确指定tsconfig路径，比如在webpack中给ts-loader设置configFile选项指向项目的tsconfig.json
  • 确认tsconfig.json位于项目根目录，且文件名无拼写错误

3. 存在配置覆盖情况 #

项目中可能有其他TypeScript配置文件（如tsconfig.app.json、tsconfig.node.json），或是转译命令行参数覆盖了target配置。

• 解决办法：
  • 检查所有TypeScript配置文件，确保它们的target字段也设为ES6
  • 查看转译工具的命令行参数，排查是否存在--target这类覆盖配置的参数

4. 编辑器缓存导致旧结果残留 #

编辑器缓存了之前的转译输出，新配置未及时生效。

• 解决办法：
  • 重启编辑器并清除缓存
  • 删除项目的转译输出目录（如dist），重新执行转译操作

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