JavaScript / TypeScript / 系统课时
理解编译与执行流程
理解编译与执行流程
TypeScript 文件不能直接交给普通 JavaScript 运行时执行。本课把“写 .ts 文件、类型检查、生成 .js、交给 Node.js 运行”串成一条完整链路,并说明检查与输出并不是同一件事。
学习目标
- 区分 TypeScript 源码、类型检查结果和 JavaScript 产物。
- 理解
tsc在检查与生成代码两个阶段中的职责。 - 能独立完成一次编译、执行并定位流程停在哪一层。
看清四个参与者
开发时至少要同时追踪源文件、TypeScript 编译器、JavaScript 产物和运行环境。tsc 读取 .ts 文件并进行类型分析,也可以生成 .js;Node.js 随后只执行生成后的 JavaScript。

这条链路最重要的边界是:类型检查发生在编译阶段,程序行为发生在 JavaScript 运行阶段。类型正确不等于业务逻辑一定正确,而 Node.js 也不会替 TypeScript 做静态类型检查。
完成一次编译与运行
先创建 src/main.ts。示例只使用普通 TypeScript 语法,编译后的 JavaScript 可以直接由 Node.js 执行。
function total(unitPrice: number, count: number): number {
return unitPrice * count;
}
const amount = total(20, 3);
console.log(`total = ${amount}`);先执行类型检查但不生成文件:
npx tsc --noEmit --target ES2022 --module commonjs src/main.ts预期结果
无终端输出,命令退出码为 0再生成 JavaScript,并让 Node.js 执行产物:
npx tsc --target ES2022 --module commonjs --outDir dist src/main.ts
node dist/main.js预期输出
total = 60第一条命令结束后会得到 dist/main.js,第二条命令执行的是这个 JavaScript 文件,而不是 src/main.ts。
理解检查与输出的开关
--noEmit 表示只检查,不写出 .js 文件,适合 CI 或提交前验证。需要真正产生产物时则不要使用该选项,并通过 target、module、outDir 等配置决定 JavaScript 的形态和输出位置。
另一个容易忽略的点是:TypeScript 在存在类型错误时是否仍生成 JavaScript,取决于 noEmitOnError。希望“类型不通过就绝不产出”时,应在项目配置中明确开启它,而不是依赖默认行为。
{
"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、构建工具或测试框架时也能知道每个工具插入在流程的哪一段。