TypeScript 安装

TypeScript 安装指南

TypeScript 的安装非常简单，主要通过 Node.js 的 npm 包管理器进行。目前（2025 年 12 月）最新稳定版本是 5.9（TypeScript 7.0 的原生重构版本预计 2026 年发布，目前仍在预览阶段）。

前置条件

• 先安装 Node.js（推荐 LTS 版本，自带 npm）。
• 下载地址：https://nodejs.org/
• 安装后，在终端（命令行）运行 node -v 和 npm -v 检查是否成功。

推荐安装方式（项目内安装，最佳实践）

在实际项目中，建议局部安装（作为开发依赖），这样每个项目可以独立使用特定版本，确保团队一致性。

1. 进入你的项目目录：

   cd your-project-folder

2. 初始化项目（如果还没有 package.json）：

   npm init -y

3. 安装 TypeScript：

   npm install typescript --save-dev

4. 编译 TS 文件使用：

   npx tsc your-file.ts

优点：版本锁定在项目中，可复现构建。

全局安装（适合快速测试或学习）

如果你想在任何地方直接使用 tsc 命令：

npm install -g typescript

• 安装完成后，检查版本：

  tsc -v

（应显示 Version 5.9.x）

中国用户加速提示（可选，避免下载慢）：
先设置淘宝镜像：

npm config set registry https://registry.npmmirror.com

然后再运行安装命令。

初始化 tsconfig.json（推荐）

安装后，在项目根目录运行：

npx tsc --init

这会生成一个 tsconfig.json 配置文件，用于自定义编译选项（如 target、module 等）。

编辑器推荐：Visual Studio Code

• 下载 VS Code：https://code.visualstudio.com/
• VS Code 内置完美支持 TypeScript，无需额外插件，就能享受到类型提示、自动补全、错误检查等功能。

简单测试

1. 创建文件 hello.ts：

   function greet(name: string): string {
     return "Hello, " + name;
   }
   console.log(greet("TypeScript"));

2. 编译：

   npx tsc hello.ts

（生成 hello.js）

3. 运行：

   node hello.js

输出：Hello, TypeScript

其他安装方式（不常用）

• Visual Studio 用户：通过 NuGet 安装 Microsoft.TypeScript.MSBuild。
• 仅转译不类型检查：可以用 Babel、swc 等工具，但不推荐（丢失类型检查优势）。

如果安装过程中遇到问题（如权限错误），可以尝试用管理员权限运行终端，或使用 sudo（Mac/Linux）。有具体错误可以告诉我，我帮你排查！继续学习的话，推荐从基本类型开始练习。