各位开发者,大家好!在进行 TypeScript 项目时,您是否发现文件数量不知不觉地增加到几十甚至几百个?此时,您是否还在终端中手动输入文件名进行构建呢? 😅
今天,我们将介绍一种标准化方法,可以100%发挥 TypeScript 编译器 (tsc) 的潜力,以最快、最准确的方式将整个项目转换为 JavaScript。

1. 答案就是 tsconfig.json 文件! 📄
虽然只需输入 tsc index.ts 即可转换单个文件,但对于项目级别的编译,tsconfig.json 配置文件是必不可少的。
- 定义: 位于项目根目录,定义编译器设置以及要包含/排除的文件列表的配置文件。
- 工作方式: 在终端中不带任何文件参数,只输入 tsc 时,编译器会从当前目录向上查找 tsconfig.json 文件。找到文件后,它会根据该设置编译整个项目。
2. 为什么 tsc(无参数)方式最有效率? 💡
这不仅仅是为了方便。这种方式高效的原因如下:
- 保持一致性: 所有开发者都将使用相同的编译选项(目标 ES 版本、模块系统等)。
- 依赖管理: 编译器会自动识别文件之间复杂的 import/export 关系,并以最优顺序进行构建。
- 性能优化: 通过 include 和 exclude 选项指定要从编译目标中排除的文件夹(例如:node_modules),可以显著提高构建速度。
3. 最有效设置的核心选项 ⚙️
为了高效编译,我们来看看 tsconfig.json 中必须包含的主要设置。
{
"compilerOptions": {
"target": "ES6", // 转换为哪个 JavaScript 版本
"module": "commonjs", // 选择模块系统
"outDir": "./dist", // 编译文件保存位置
"rootDir": "./src", // 源文件所在起点
"strict": true, // 严格类型检查(强烈推荐!)
"skipLibCheck": true // 跳过检查库文件(*.d.ts)(提高构建速度)
},
"include": ["src/**/*"], // 将 src 文件夹中的所有文件指定为编译目标
"exclude": ["node_modules"] // 要排除的路径
}
4. 提高生产力的实用技巧 (Advanced) 🚀
介绍两种使整个项目构建更智能的额外方法。
① 增量编译 (Incremental Compilation)
在 tsconfig.json 中添加 “incremental”: true 选项。这会将上次的构建信息保存到文件中,只编译已更改的部分,从而大大缩短再次构建的时间。
② 结合 Watch 模式
正如之前的文章中提到的,运行 tsc –watch(或 tsc -w)命令会在每次保存文件时自动编译并反映整个项目的更改。
5. 总结:高效构建流程清单 📋
- 在项目根目录创建 tsconfig.json。 (命令: tsc –init)
- 通过设置 include 和 outDir 等定义项目结构。
- 在终端中只运行 tsc 命令。
- 重复修改时,使用 tsc -w 进行实时编译。
🏁 总结
TypeScript 项目的高效编译始于“一个准确的配置文件”。摆脱过去手动输入文件名的做法,用一个 tsc 命令控制整个项目。构建速度越快,您的专注力就能保持得越久! 💪
发表回复