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 输出与预期一致。

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

目录与阅读设置

阅读设置

17

记录一个想法

创建第一个 TypeScript 项目

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

登录哪都通