JavaScript / TypeScript / 系统课时
创建第一个 TypeScript 项目
创建第一个 TypeScript 项目
本课把已安装的工具链真正运行起来。你将初始化配置文件、编写第一个 TypeScript 程序、编译生成 JavaScript,并用 Node.js 验证输出结果。
学习目标
- 初始化 TypeScript 项目配置
- 编写并编译第一个 TypeScript 文件
- 理解源文件与输出文件的目录关系
初始化配置
进入上一课创建的项目目录,生成 tsconfig.json:
bash
npx tsc --init预期结果
text
当前目录生成 tsconfig.json。为便于观察本课流程,可以把配置精简为以下内容:
json
{
"compilerOptions": {
"target": "ES2020",
"module": "CommonJS",
"rootDir": "src",
"outDir": "dist",
"strict": true
},
"include": ["src"]
}这是一份配置文件,不直接产生控制台输出。保存后可通过 npx tsc --showConfig 查看编译器解析出的最终配置。
编写第一个程序
创建 src/index.ts:
ts
const learner: string = "Anystack 学员";
const completedLessons: number = 1;
function buildMessage(name: string, count: number): string {
return `${name} 已完成 ${count} 个 TypeScript 课时`;
}
console.log(buildMessage(learner, completedLessons));代码显式声明了变量、参数和返回值类型。虽然部分类型可由编译器自动推断,但此处保留标注,便于第一次观察类型约束。
编译项目
在项目根目录执行:
bash
npx tsc预期结果
text
命令无错误结束,并生成 dist/index.js。默认情况下,编译成功时 tsc 可能不输出任何文本。判断是否成功,应检查退出状态以及 dist/index.js 是否存在。
运行 JavaScript
Node.js 执行的是编译后的 JavaScript 文件:
bash
node dist/index.js预期输出
text
Anystack 学员 已完成 1 个 TypeScript 课时此时项目结构应类似:
text
typescript-basics/
├── dist/
│ └── index.js
├── src/
│ └── index.ts
├── node_modules/
├── package.json
├── package-lock.json
└── tsconfig.json目录树是结构说明,不是可执行命令。src 保存源代码,dist 保存编译产物,通常不应直接在 dist 中修改文件。
验收与常见问题
若提示找不到输入文件,检查 src/index.ts 是否存在以及 include 是否覆盖 src。若提示文件不在 rootDir 中,说明源文件位置与配置不一致。
若运行时找不到 dist/index.js,先确认编译是否成功,再检查 outDir 是否被修改。完成验收的标准是:编译无错误、输出文件存在、Node.js 输出与预期一致。
按自己的节奏,确认真正理解。