第一章：环境搭建

1. 安装 Node.js

TypeScript 运行在 Node.js 之上。前往 nodejs.org 下载 LTS（长期支持）版本，推荐 Node.js 20+。

安装完成后，验证安装：

node -v    # 例如 v20.11.0
npm -v     # 例如 10.2.4

包管理器选择

Node.js 自带 npm，但你也可以选择更快的替代品：

• npm — 默认包管理器，开箱即用
• pnpm — 更快、节省磁盘空间，推荐：npm install -g pnpm
• yarn — Facebook 出品，也是不错的选择

2. 安装 TypeScript

全局安装 TypeScript 编译器

npm install -g typescript
tsc --version   # 例如 Version 5.4.5

直接运行 TS 的工具

每次先编译再运行太繁琐？以下工具可以直接执行 .ts 文件：

3. Hello World

创建文件 hello.ts：

const greeting: string = "Hello, TypeScript!";
const year: number = 2026;

console.log(`${greeting} 现在是 ${year} 年。`);

方式一：编译后运行

# 编译 .ts → .js
tsc hello.ts

# 运行编译后的 JS
node hello.js

方式二：直接运行（推荐开发时使用）

# 使用 tsx（无需全局安装，npx 会自动下载）
npx tsx hello.ts

# 或者使用 ts-node
npx ts-node hello.ts

4. tsconfig.json 配置

使用以下命令生成默认配置文件：

tsc --init

推荐的 tsconfig.json 配置：

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "Node16",
    "moduleResolution": "Node16",
    "strict": true,
    "outDir": "./dist",
    "rootDir": "./src",
    "esModuleInterop": true,
    "resolveJsonModule": true,
    "declaration": true,
    "sourceMap": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}

关键配置项说明

5. VS Code 配置

VS Code 内置了强大的 TypeScript 支持（语法高亮、智能提示、重构、类型检查），无需额外配置即可使用。

推荐插件

6. 项目脚手架

初始化项目

# 创建项目目录
mkdir my-ts-project && cd my-ts-project

# 初始化 package.json
npm init -y

# 安装 TypeScript 为开发依赖（推荐，而非全局安装）
npm install typescript --save-dev

# 生成 tsconfig.json
npx tsc --init

# 创建目录结构
mkdir src dist

典型目录结构

my-ts-project/
├── src/
│   ├── index.ts          # 入口文件
│   └── utils/
│       └── helper.ts
├── dist/                  # 编译输出（git忽略）
├── node_modules/          # 依赖（git忽略）
├── package.json
├── tsconfig.json
└── .gitignore

配置 package.json scripts

{
  "scripts": {
    "build": "tsc",
    "start": "node dist/index.js",
    "dev": "tsx watch src/index.ts",
    "lint": "eslint src/"
  }
}

现在你可以用以下命令进行开发：

npm run dev    # 开发模式，文件修改自动重新运行
npm run build  # 编译为 JS
npm start      # 运行编译后的代码