JavaScript / TypeScript / 系统课时

编译并运行代码

编译并运行代码

这一课把 TypeScript 从源码变成可执行结果的流程串起来:既会处理单个 .ts 文件,也会使用 tsconfig.json 编译整个项目,并把产物集中到输出目录后交给 Node.js 运行。

学习目标

  • 使用 tsc 编译单个 TypeScript 文件并运行产物
  • 使用 tsconfig.json 管理项目编译与输出目录
  • 根据编译结果快速定位常见路径和模块问题

编译单个文件

先准备 app.ts:

ts
function greet(name: string): string {
  return `Hello, ${name}!`;
}

console.log(greet("TypeScript"));

在当前目录执行编译,再用 Node.js 运行生成的 JavaScript:

bash
npx tsc app.ts --target ES2020 --module commonjs
node app.js

预期输出:

text
Hello, TypeScript!

这里的 npx tsc 调用项目可用的 TypeScript 编译器;--target ES2020 控制生成 JavaScript 的语法版本,--module commonjs 指定模块输出形式。单文件方式适合快速实验,但项目增大后不宜反复在命令行堆选项。

使用项目配置编译

项目编译通常把规则写进 tsconfig.json。下面是一个最小配置:

json
{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "rootDir": "src",
    "outDir": "dist",
    "strict": true,
    "noEmitOnError": true
  },
  "include": ["src/**/*.ts"]
}

把源码放到 src/app.ts 后执行:

bash
npx tsc -p .

预期结果:

text
命令成功结束;若没有诊断信息,终端通常不输出内容,并在 dist 目录生成对应的 JavaScript 文件。

-p . 表示从当前目录读取项目配置。rootDir 约束源码根目录,outDir 决定编译产物位置;两者配合后,源码与生成文件不会混在一起。

运行编译结果

项目编译完成后,实际执行的是 dist 中的 JavaScript,而不是原始 TypeScript:

bash
node dist/app.js

预期输出:

text
Hello, TypeScript!

修改 src/app.ts 后,需要重新执行 npx tsc -p . 才会更新 dist/app.js。如果直接运行旧产物,就可能出现“源码明明改了,结果却没变”的错觉。

检查输出目录

判断编译是否真的成功,最直接的方法不是只看终端,而是同时确认目标文件存在。macOS、Linux 或常见类 Unix shell 可执行:

bash
ls dist

预期输出:

text
app.js

Windows PowerShell 可使用 Get-ChildItem dist 做同样检查。实际项目中如果包含多个源码文件,dist 会按照编译后的目录结构出现多个 .js 文件。

常见失败怎么定位

如果 npx tsc -p . 报“找不到输入文件”,先检查 include 是否覆盖实际源码路径,以及源码是否位于 rootDir 下。若 Node.js 报“Cannot find module”,优先确认运行路径是否指向真实生成的文件。

最可靠的闭环是:改 TypeScript 源码 → 执行项目编译 → 确认 dist 产物更新 → 运行 JavaScript → 对照预期输出。只要按这个顺序检查,绝大多数初学阶段的编译与运行问题都能快速缩小范围。

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

目录与阅读设置

阅读设置

17

记录一个想法

编译并运行代码

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

登录哪都通