解决 TypeScript 配置 async/await 编译目标 ES2017 报错，核心是检查 tsconfig.json 中 target 与 lib 字段是否匹配，并确认运行环境支持 ES2017 语法。若项目依赖现代构建工具，建议直接将 target 升级为 ES2020 以减少兼容性问题。

命令速用版

在 tsconfig.json 中显式声明 target 和 lib，确保模块系统一致。若使用 Node.js 环境，需在 package.json 中声明模块类型。

{
  "compilerOptions": {
    "target": "ES2017",
    "lib": ["ES2017", "DOM"],
    "module": "ESNext",
    "moduleResolution": "Node"
  },
  "include": ["src"]
}

若使用 Node.js 运行，确保 package.json 包含 type 字段：

{
  "type": "module"
}

为什么会这样

TypeScript 编译器的行为完全由 tsconfig.json 控制，target 决定语法转换，lib 决定类型定义。同一个 TypeScript 代码，在不同的 tsconfig 配置下可能编译出完全不同的结果，模块格式不同、目标语法不同、甚至有些写法能过编译有些不能。若 target 设为 ES2017 但 lib 缺失，编译器无法识别 Promise 或 async 函数类型定义，从而报错。

分步处理

第一步：检查 tsconfig.json 配置。确认 compilerOptions 中 target 设置为 ES2017 或更高，lib 数组包含 ES2017。若使用 ES 模块语法，module 应设置为 ESNext 或 ES2020。

第二步：检查 package.json 模块声明。Node.js 要求项目根目录的 package.json 显式声明类型，添加 type 为 module 以启用 ES 模块支持，否则 Node.js 默认以 CommonJS 模式加载文件，导致模块解析失败。

第三步：确认运行环境版本。即使 TypeScript 配置正确，运行环境也必须启用 ES 模块支持。Node.js 建议使用 16+ 版本以匹配 node16 模块解析策略，避免默认导入兼容性问题。

怎么验证是否生效

执行 tsc `--noEmit` 命令检查类型编译是否通过，若无报错则配置正确。运行编译后的 JavaScript 文件，观察控制台是否出现 SyntaxError 或 Cannot use import statement outside a module 错误。若使用打包工具，确认其配置启用 ES 模块支持，输出文件格式应为 ES 模块。

常见坑

开发中为快速规避类型报错直接使用 any，完全失去 TS 静态类型检查能力，等同于退回 JavaScript，极易产生线上隐性 bug。接口存在可选字段时，直接访问子属性会触发 TS 类型警告，未做空判断会出现运行空报错，建议使用可选链操作符。配置不一致是模块识别失败的主要原因，开发者应确保 TypeScript 编译选项与运行时环境保持协同。

常见问题

必须将 target 设置为 ES2020 吗？

不是必须，但推荐。ES2017 支持 async/await，但 ES2020 以上能更好地支持现代语法和构建工具优化，减少配置冲突。

Node.js 版本过低会报错吗？

会。Node.js 版本过低可能不支持 ES2017 原生 async/await 或 ES 模块语法，建议使用 Node.js 16 及以上版本。

为什么配置对了还是找不到模块？

模块解析策略可能不匹配。若使用 ES 模块，moduleResolution 应设为 node16 或 Node，确保遵循 Node.js 模块查找规则。

参考来源

• ES 模块在 TypeScript 中配置失败？一文解决你遇到的所有问题
• TypeScript 项目配置:tsconfig、ESM、路径别名
• 为什么你的 TypeScript 项目无法识别 ES 模块？深度剖析配置根源
• 紧急避坑！TypeScript 项目升级 ES 模块后必做的 5 项配置调整
• TypeScript 项目开发实战常见问题与代码解决方案