对于许多开发者而言，从 JavaScript 迁移到 TypeScript 是提升代码健壮性的关键一步。然而，配置正确的开发环境往往是新手面临的第一道门槛。本文基于 Codex 中文指南的视角，为你梳理在本地环境中快速启动 TypeScript 项目的核心步骤，解决“如何安装”这一基础但至关重要的问题。
前置条件与 Node.js 准备
TypeScript 本质上是一个编译型工具，它依赖于运行时的执行环境。因此，在安装 TypeScript 之前，确保你的计算机已安装 Node.js 是必不可少的前提。Node.js 不仅提供了运行环境，还附带了包管理器 npm（或 yarn/pnpm），这是获取和管理 TypeScript 编译器及其类型定义的关键渠道。建议通过官方渠道下载 LTS（长期支持）版本的 Node.js，以保证环境的稳定性。安装完成后，你可以在终端输入 node -v 和 npm -v 来验证安装是否成功。
全局与局部安装策略
关于“如何安装”TypeScript，社区中通常存在两种主流方式：全局安装和项目局部安装。全局安装允许你在任何目录下使用 tsc 命令，适合初学者快速体验或进行简单的脚本测试。你只需在终端执行 npm install -g typescript 即可。然而，在实际的企业级项目开发中，我们更推荐项目局部安装。这种方式将 TypeScript 版本锁定在项目的 package.json 文件中，确保团队成员使用完全一致的编译器版本，避免“在我机器上能跑”的环境差异问题。通过 npm install --save-dev typescript 即可完成这一配置。
初始化与首次编译
安装完成后，下一步是生成配置文件。在项目根目录运行 npx tsc --init，这将创建一个 tsconfig.json 文件。这个文件是 TypeScript 编译器的核心配置项，定义了目标 ECMAScript 版本、模块系统以及输出目录等关键参数。完成配置后，你可以编写一个简单的 .ts 文件，并在终端执行 npx tsc 进行编译。如果一切顺利，你将看到生成的 .js 文件，这标志着你的 TypeScript 开发环境已正式就绪。遵循这些步骤，你将能够在一个标准化的环境中高效地进行类型安全的代码开发。