JavaScript / TypeScript / 系统课时

理解编译与执行流程

理解编译与执行流程

TypeScript 文件不能直接交给普通 JavaScript 运行时执行。本课把“写 .ts 文件、类型检查、生成 .js、交给 Node.js 运行”串成一条完整链路,并说明检查与输出并不是同一件事。

学习目标

  • 区分 TypeScript 源码、类型检查结果和 JavaScript 产物。
  • 理解 tsc 在检查与生成代码两个阶段中的职责。
  • 能独立完成一次编译、执行并定位流程停在哪一层。

看清四个参与者

开发时至少要同时追踪源文件、TypeScript 编译器、JavaScript 产物和运行环境。tsc 读取 .ts 文件并进行类型分析,也可以生成 .js;Node.js 随后只执行生成后的 JavaScript。

TypeScript 从源码到 Node.js 的编译执行链路

这条链路最重要的边界是:类型检查发生在编译阶段,程序行为发生在 JavaScript 运行阶段。类型正确不等于业务逻辑一定正确,而 Node.js 也不会替 TypeScript 做静态类型检查。

完成一次编译与运行

先创建 src/main.ts。示例只使用普通 TypeScript 语法,编译后的 JavaScript 可以直接由 Node.js 执行。

ts
function total(unitPrice: number, count: number): number {
  return unitPrice * count;
}

const amount = total(20, 3);
console.log(`total = ${amount}`);

先执行类型检查但不生成文件:

bash
npx tsc --noEmit --target ES2022 --module commonjs src/main.ts

预期结果

text
无终端输出,命令退出码为 0

再生成 JavaScript,并让 Node.js 执行产物:

bash
npx tsc --target ES2022 --module commonjs --outDir dist src/main.ts
node dist/main.js

预期输出

text
total = 60

第一条命令结束后会得到 dist/main.js,第二条命令执行的是这个 JavaScript 文件,而不是 src/main.ts。

理解检查与输出的开关

--noEmit 表示只检查,不写出 .js 文件,适合 CI 或提交前验证。需要真正产生产物时则不要使用该选项,并通过 target、module、outDir 等配置决定 JavaScript 的形态和输出位置。

另一个容易忽略的点是:TypeScript 在存在类型错误时是否仍生成 JavaScript,取决于 noEmitOnError。希望“类型不通过就绝不产出”时,应在项目配置中明确开启它,而不是依赖默认行为。

json
{
  "compilerOptions": {
    "target": "ES2022",
    "module": "CommonJS",
    "outDir": "dist",
    "noEmitOnError": true
  },
  "include": ["src/**/*.ts"]
}

这份配置生效后,执行 npx tsc 会按项目配置检查并生成代码;若发生类型错误,则不会写出新的 JavaScript 产物。验证时可以先删除 dist,再执行编译并检查目录是否重新生成。

按阶段定位问题

看到报错时,先判断它属于哪一层。编辑器中的红线和 tsc 错误通常属于类型检查;Cannot find module、端口占用或运行时异常则发生在 JavaScript 已经交给 Node.js 之后。

排查时按“源文件是否正确 → tsc 是否通过 → JavaScript 是否生成 → Node.js 是否能执行”的顺序推进,比把所有问题都归因于“TypeScript 编译失败”更快。掌握这四层边界后,后续配置 tsconfig.json、构建工具或测试框架时也能知道每个工具插入在流程的哪一段。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解编译与执行流程

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

登录哪都通