target 和 module 是 tsconfig.json 中控制编译输出行为最核心的两个配置项：target 指定生成 javascript 的 ecmascript 版本（如 es5、es2022、esnext），决定语法降级程度；module 指定模块系统格式（如 commonjs、es2020、esnext），影响 import/export 转换方式与运行时加载行为，二者必须兼容且需匹配目标环境。
target 和 module 是 tsconfig.json 中控制编译输出行为最核心的两个配置项，它们共同决定生成 JavaScript 的语法版本和模块组织形式，直接影响代码能否在目标环境正确运行。
target 控制语法降级标准
它指定 TypeScript 编译后生成的 JavaScript 语言版本（ECMAScript 标准），比如是否保留箭头函数、const/let、async/await、可选链等特性。
- 选 "es5"：兼容 IE11、旧版 Node.js（如 v6–v10），所有现代语法都会被转译（如 class → function，箭头函数 → function）
- 选 "es2017" 或更高（如 "es2020"、"es2022"）：面向较新环境（Node.js ≥ 12、Chrome ≥ 68、Firefox ≥ 57），保留更多原生语法，体积更小、性能更好
- 选 "esnext"：不锁定具体版本，始终使用当前 TypeScript 支持的最新 ECMAScript 特性（如顶层 await、class 私有字段），适合开发阶段或构建工具后续再做兼容处理
module 决定模块系统格式
它定义编译后的 import/export 如何被转换，影响模块加载方式和运行时行为。
- "commonjs"：生成 require/module.exports 语法，适用于 Node.js 环境或 Webpack/Vite 等打包器（默认支持）
- "es2015" 或 "es2020" 或 "esnext"：保留 import/export 语句，生成真正的 ES 模块，适用于现代浏览器直接加载或构建工具按需打包
- 注意：target 和 module 必须兼容。例如 target 为 "es5" 时，module 不能设为 "es2015"（ES5 环境不原生支持 import/export），否则会报错；常见安全组合是：target: "es5" + module: "commonjs"，或 target: "es2017" + module: "es2020"
搭配建议取决于项目类型
不同场景下推荐组合不同，不是越新越好，而是匹配实际运行环境。
- Node.js 后端项目：target 可设为运行环境支持的最低版本（如 "es2019" 对应 Node.js 12+），module 固定用 "commonjs"
- 现代 Web 应用（Vite/React/Vue）：target 和 module 均可用 "es2020" 或 "esnext"，由构建工具统一处理兼容性
- 发布到 npm 的库：通常同时输出多份产物 —— 用 "esnext" + "es2020" 生成 ESM 版本（供现代打包器使用），另配一份 "es5" + "commonjs" 作为 fallback
验证配置是否生效
改完 tsconfig.json 后，运行 tsc --noEmit 检查是否有配置冲突错误；再执行 tsc -w 观察输出的 .js 文件，确认语法和 import/export 形式符合预期。
