JavaScript / TypeScript / 系统课时
编译并运行代码
编译并运行代码
这一课把 TypeScript 从源码变成可执行结果的流程串起来:既会处理单个 .ts 文件,也会使用 tsconfig.json 编译整个项目,并把产物集中到输出目录后交给 Node.js 运行。
学习目标
- 使用
tsc编译单个 TypeScript 文件并运行产物 - 使用
tsconfig.json管理项目编译与输出目录 - 根据编译结果快速定位常见路径和模块问题
编译单个文件
先准备 app.ts:
function greet(name: string): string {
return `Hello, ${name}!`;
}
console.log(greet("TypeScript"));在当前目录执行编译,再用 Node.js 运行生成的 JavaScript:
npx tsc app.ts --target ES2020 --module commonjs
node app.js预期输出:
Hello, TypeScript!这里的 npx tsc 调用项目可用的 TypeScript 编译器;--target ES2020 控制生成 JavaScript 的语法版本,--module commonjs 指定模块输出形式。单文件方式适合快速实验,但项目增大后不宜反复在命令行堆选项。
使用项目配置编译
项目编译通常把规则写进 tsconfig.json。下面是一个最小配置:
{
"compilerOptions": {
"target": "ES2020",
"module": "commonjs",
"rootDir": "src",
"outDir": "dist",
"strict": true,
"noEmitOnError": true
},
"include": ["src/**/*.ts"]
}把源码放到 src/app.ts 后执行:
npx tsc -p .预期结果:
命令成功结束;若没有诊断信息,终端通常不输出内容,并在 dist 目录生成对应的 JavaScript 文件。-p . 表示从当前目录读取项目配置。rootDir 约束源码根目录,outDir 决定编译产物位置;两者配合后,源码与生成文件不会混在一起。
运行编译结果
项目编译完成后,实际执行的是 dist 中的 JavaScript,而不是原始 TypeScript:
node dist/app.js预期输出:
Hello, TypeScript!修改 src/app.ts 后,需要重新执行 npx tsc -p . 才会更新 dist/app.js。如果直接运行旧产物,就可能出现“源码明明改了,结果却没变”的错觉。
检查输出目录
判断编译是否真的成功,最直接的方法不是只看终端,而是同时确认目标文件存在。macOS、Linux 或常见类 Unix shell 可执行:
ls dist预期输出:
app.jsWindows PowerShell 可使用 Get-ChildItem dist 做同样检查。实际项目中如果包含多个源码文件,dist 会按照编译后的目录结构出现多个 .js 文件。
常见失败怎么定位
如果 npx tsc -p . 报“找不到输入文件”,先检查 include 是否覆盖实际源码路径,以及源码是否位于 rootDir 下。若 Node.js 报“Cannot find module”,优先确认运行路径是否指向真实生成的文件。
最可靠的闭环是:改 TypeScript 源码 → 执行项目编译 → 确认 dist 产物更新 → 运行 JavaScript → 对照预期输出。只要按这个顺序检查,绝大多数初学阶段的编译与运行问题都能快速缩小范围。