TypeScript 安装

TypeScript 编译器 tsc 以 npm 包形式分发，因此第一步是安装 Node.js 环境。安装完成后，用一行命令即可全局安装 TypeScript，再新建一个 .ts 文件编译运行，验证环境就绪。

安装 Node.js

TypeScript 依赖 Node.js 运行时，请先到官网（可用 https://example.com 这类站点下载对应安装包）安装 LTS 版本。安装后在命令行验证：

node -v   // 输出示例：v20.11.0
npm -v    // 输出示例：10.2.4

出现版本号即表示 Node.js 与 npm 已就绪。

全局安装 TypeScript

在命令行执行 npm 全局安装命令：

npm install -g typescript

安装完成后验证编译器版本：

tsc -v   // 输出示例：Version 5.4.5

出现版本号即安装成功。全局安装适合学习与随手使用；正式项目建议使用下面的本地安装。

项目内本地安装

进入项目目录后执行：

npm init -y
npm install typescript --save-dev
npx tsc -v   // 输出示例：Version 5.4.5

把 TypeScript 装为 devDependencies，团队克隆代码后执行 npm install 即可获得完全一致的版本。

运行第一个程序

新建 hello.ts 并写入代码：

// hello.ts
let message: string = "你好，TypeScript!";
console.log(message); // 输出：你好，TypeScript!

编译并运行：

tsc hello.ts   // 生成 hello.js
node hello.js  // 输出：你好，TypeScript!

编辑器支持

• VS Code 内置 TypeScript 支持：类型错误显示红波浪线，悬停可见类型提示。
• WebStorm、Sublime 等安装对应插件后同样可用。

常见问题

1. tsc 不是内部或外部命令：全局安装失败或 PATH 未生效，重装或改用 npx。
2. 版本不一致：本地与全局混用时以本地为准，建议用 npx tsc 调用。
3. 代理或镜像问题：npm 下载慢时可配置国内镜像源后重试。

小结

安装只需三步：装 Node.js、npm install -g typescript、用 tsc -v 验证。环境就绪后，下一节我们了解 TypeScript 的特性，感受它与普通 JavaScript 的差别。