Skip to content

安装 TypeScript

概述

TypeScript 可以通过多种方式安装。你可以选择全局安装(适用于命令行工具)或项目本地安装(推荐用于项目开发)。本文档将介绍不同的安装方法和最佳实践。

安装方法

方法 1:使用 npm 安装(推荐)

全局安装

bash
npm install -g typescript

安装完成后,可以使用 tsc 命令:

bash
tsc --version

项目本地安装

bash
# 在项目目录中执行
npm install --save-dev typescript

本地安装后,可以通过 npx 使用:

bash
npx tsc --version

方法 2:使用 yarn 安装

全局安装

bash
yarn global add typescript

项目本地安装

bash
yarn add -D typescript

方法 3:使用 pnpm 安装

全局安装

bash
pnpm add -g typescript

项目本地安装

bash
pnpm add -D typescript

版本选择

查看可用版本

bash
npm view typescript versions

安装特定版本

bash
# 安装最新稳定版
npm install -D typescript@latest

# 安装特定版本
npm install -D typescript@5.3.0

# 安装 beta 版本(体验新特性)
npm install -D typescript@beta

版本选择建议

  • 生产环境:使用最新的稳定版本(latest)
  • 新项目:使用最新版本,享受最新特性和改进
  • 现有项目:谨慎升级,先测试兼容性

验证安装

安装完成后,验证 TypeScript 是否正确安装:

bash
# 检查版本
tsc --version
# 或
npx tsc --version

# 应该输出类似:Version 5.3.0

创建第一个 TypeScript 文件

验证安装后,创建一个简单的 TypeScript 文件:

typescript
// hello.ts
function greet(name: string): string {
  return `Hello, ${name}!`;
}

console.log(greet("TypeScript"));

编译 TypeScript 文件:

bash
tsc hello.ts

这会生成 hello.js 文件。

项目初始化

初始化 TypeScript 项目

bash
# 创建项目目录
mkdir my-typescript-project
cd my-typescript-project

# 初始化 npm 项目
npm init -y

# 安装 TypeScript
npm install -D typescript

# 创建 tsconfig.json
npx tsc --init

推荐的 package.json 配置

json
{
  "name": "my-typescript-project",
  "version": "1.0.0",
  "scripts": {
    "build": "tsc",
    "watch": "tsc --watch",
    "type-check": "tsc --noEmit"
  },
  "devDependencies": {
    "typescript": "^5.3.0"
  }
}

使用 TypeScript 编译器

基本编译

bash
# 编译单个文件
tsc app.ts

# 编译项目(使用 tsconfig.json)
tsc

# 监听模式(自动重新编译)
tsc --watch

常用编译选项

bash
# 只进行类型检查,不生成文件
tsc --noEmit

# 指定输出目录
tsc --outDir dist

# 启用严格模式
tsc --strict

注意事项

推荐做法

优先使用项目本地安装,而不是全局安装。这样可以:

  • 确保团队成员使用相同版本
  • 避免版本冲突
  • 更好地管理依赖

注意

全局安装的 TypeScript 版本可能与项目中的版本不同,可能导致编译结果不一致。

信息

如果使用现代构建工具(如 Vite、Webpack),通常不需要手动运行 tsc,构建工具会自动处理 TypeScript 编译。

相关链接

基于 VitePress 构建