安装与环境配置

准备工作：确认 Node.js

TypeScript 的编译器 tsc 是通过 npm（Node.js 的包管理器）分发的。在装 TS 之前，先确认你的电脑上有 Node.js。

打开终端（Windows 用 PowerShell 或 CMD，macOS/Linux 用 Terminal），输入：

node -v

如果返回了版本号（比如 v20.0.0 或更高），就说明一切就绪。TypeScript 7.0 对 Node.js 的最低版本要求是 18.x，推荐使用 20.x 或 22.x LTS。

如果还没有 Node.js，去 nodejs.org 下载 LTS 版本安装，一路下一步就行。装完之后 node -v 和 npm -v 都确认有输出，再继续。

方式一：全局安装（适合尝鲜）

全局安装后，tsc 命令在任何目录下都能直接用，适合你刚开始学、想随时测试一两行代码的场景。

npm install -g typescript

安装完成后，用版本检查命令确认：

tsc -v

如果你看到类似 Version 7.0.2 的输出，恭喜——TypeScript 已经乖乖待在你的电脑里了。

全局安装的优点很明显：一条命令搞定，去哪都能用。但它也有个隐患：如果你在不同项目里装了不同版本的 TypeScript，全局版可能会跟项目版冲突。所以全局安装推荐只用来学习、做实验。

方式二：项目本地安装（推荐）

正经做项目的时候，应该把 TypeScript 装成项目的开发依赖。这样你的项目在哪个电脑上跑，装的 TypeScript 版本都是一致的。

在你的项目根目录里执行：

npm install -D typescript

-D 是 --save-dev 的缩写，意思是把 TypeScript 记录到 package.json 的 devDependencies 里。这样团队里其他人 clone 代码之后跑一句 npm install，就能拿到完全一样的 TS 版本。

装完之后，你可能会问：命令在哪？本地安装的 tsc 不在系统 PATH 里，而是在 node_modules/.bin/ 目录下。你有两种方式调用它：

用 npx 调用（推荐）

npx tsc -v

npx 会自动在项目的 node_modules/.bin/ 里找 tsc，找到就直接用。这是最推荐的方式——不需要全局安装，也不会搞混版本。

用 package.json scripts 调用

在 package.json 里加上脚本：

{
  "scripts": {
    "build": "tsc",
    "check": "tsc --noEmit"
  }
}

然后：

npm run build    # 编译 TypeScript
npm run check    # 只检查类型，不输出 JS

写在 scripts 里的命令会自动添加 node_modules/.bin 到 PATH，所以你直接用 tsc 就行，不用加 npx。

全局 vs 本地：怎么选

场景	推荐方式
刚开始学，随手写 demo	全局安装 npm install -g typescript
做个人项目 / 团队项目	本地安装 npm install -D typescript
已有项目	先看 package.json 里有没有装，没有就 npm install -D typescript

我的建议：两者都装。全局版用来随手测试，本地版用在每个实际项目里。两者不冲突，npx 会优先用本地版，tsc 直接调用会走全局版。

初始化项目配置

如果你是从零开始建项目，一条命令生成标准配置：

npx tsc --init

这会在当前目录创建一个 tsconfig.json。TypeScript 7.0 的 --init 默认已经包含了 strict: true 和 module: "esnext"——这是两件好事，后面章节会详细讲。现在知道有这个命令就行。

确认环境就绪

跑完以上步骤后，做一个快速验证：

# 检查 Node 版本
node -v

# 检查 TypeScript 版本
npx tsc -v

两个命令都正常输出版本号，你的 TypeScript 环境就算搭好了。

下一章，我们用这套环境写出生平第一个 TypeScript 程序。