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。
{
"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 标准库完成编译。
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。
npm install --save-dev typescript
npx tsc -p tsconfig.json
find dist -maxdepth 1 -type f | sort预期输出:
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、映射文件和目录层级
下一课预告
下一课将启用增量缓存、监听模式和项目引用,让单项目与多包项目只重建真正发生变化的部分。