安装 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 编译。