JavaScript / TypeScript / 系统课时

配置编译目标与输出

配置编译目标与输出

tsconfig.json 决定 TypeScript 按什么 JavaScript 版本输出、可使用哪些标准库类型,以及源码和构建产物放在哪里。本课用一个可编译的小项目完成配置,并验证 dist 目录和源码映射文件是否按预期生成。

学习目标

  • 根据实际运行环境选择 target、module 和 lib
  • 正确配置 rootDir、outDir、include 与 exclude
  • 编译并检查 JavaScript 与 Source Map 产物

先确定运行环境

target 控制降级后的 JavaScript 语法,应该以最低运行环境为准,而不是盲目选择最旧版本。module 控制模块输出和解析方式;现代 Node.js 项目通常成对使用 NodeNext,由打包器处理模块的前端项目则常保留较新的模块语法。

lib 只提供类型声明,不会自动安装运行时能力。Node.js 项目可从 ES2022 等标准库开始;浏览器代码若使用 document、fetch 等 Web API,还要加入 DOM。升级或调整这些选项时,应以项目实际运行环境和依赖要求为准。:contentReference[oaicite:0]{index=0}

下面的配置面向支持 ES2022 的 Node.js 环境。它是完整配置文件,可直接保存为项目根目录的 tsconfig.json。

json
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "lib": ["ES2022"],
    "rootDir": "src",
    "outDir": "dist",
    "sourceMap": true,
    "strict": true
  },
  "include": ["src/**/*.ts"],
  "exclude": ["dist", "node_modules"]
}

rootDir 描述源码目录结构的起点,outDir 指定输出目录;编译器会在输出目录中保留相对目录结构。真正决定哪些文件进入项目的是 include、files 以及导入关系,而不是 rootDir。:contentReference[oaicite:1]{index=1}

配置源码与输出目录

创建 src/index.ts,使用不依赖 Node.js 专用类型的代码,便于只用 ES2022 标准库完成编译。

ts
const cents: number = 2599;

export const amountText: string = (cents / 100).toFixed(2);

这里的源码位于 src,所以输出文件会落到 dist/index.js。启用 sourceMap 后,还会生成 dist/index.js.map,调试器可借助映射文件把 JavaScript 执行位置还原到 TypeScript 源码。

编译并验证产物

先在项目中安装 TypeScript,然后执行项目级编译。以下命令假设当前目录已经包含前面的 tsconfig.json 和 src/index.ts。

bash
npm install --save-dev typescript
npx tsc -p tsconfig.json
find dist -maxdepth 1 -type f | sort

预期输出:

text
dist/index.js
dist/index.js.map

成功编译时 tsc 通常不额外输出信息,最后两行来自 find。Windows PowerShell 可改用 Get-ChildItem dist 检查文件,文件排序和显示格式可能不同。

关键边界与常见错误

当出现“文件不在 rootDir 下”时,不要只扩大 rootDir 掩盖问题,应先检查 include 是否误收测试、脚本或其他包的源码。构建目录也应放入 exclude,避免编辑器或工具重复扫描生成文件。

若浏览器项目报 Cannot find name 'document',说明 lib 缺少 DOM;若 Node.js 项目报 Cannot find name 'process',应安装并启用对应的 Node.js 类型声明,而不是把 DOM 当作通用补丁。

Source Map 便于排查线上堆栈,但可能暴露源码路径或源内容。生产环境是否发布 .map 文件,应结合错误监控、静态资源权限和发布策略决定。

本课总结

  • target、module 与 lib 必须围绕实际运行环境协同配置
  • include 决定输入范围,rootDir 和 outDir 决定输出结构
  • 编译后应同时验证 JavaScript、映射文件和目录层级

下一课预告

下一课将启用增量缓存、监听模式和项目引用,让单项目与多包项目只重建真正发生变化的部分。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置编译目标与输出

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通