设置 TypeScript

本章假定学习者具备一定的 TypeScript 和 JavaScript 基础知识。这意味着我们不会解释函数、变量等基本概念。不过，本章中的内容对日常使用语言经验较少的读者仍可能有所帮助。对于经验丰富的程序员，可以跳过或快速浏览本章。

环境要求

若想在本地复现本课程中的示例，你的计算机上需要安装 node 和 npm。需要注意的是，npm 随 node 一同提供，因此只需安装 node 即可。你可以在终端中输入 node -v 和 npm -v 来检查是否已正确安装。如果安装成功，应返回版本号，例如 v14.18.3。请在下方提供的终端窗口中尝试运行这些命令。

创建新项目

在上方的终端中运行 npm init 命令以创建项目目录。

对于 JavaScript 示例，无需额外配置。当进入 fp-ts 部分时，你需要将 TypeScript 和 fp-ts 添加到依赖项中。此外还有一些其他依赖项是必需的，但将在后续章节中讨论。

TypeScript 及其类型声明包（为现有 JavaScript 库添加类型）可以放在 devDependencies 中，因为它们仅在开发阶段使用，运行时不需要。因此，目前你的 package.json 文件大致如下，具体取决于你回答的问题：

1{
2  "name": "fpintypescript",
3  "version": "1.0.0",
4  "scripts": {
5    "test": "echo \"Error: no test specified\" && exit 1"
6  },
7  "dependencies": {
8    "fp-ts": "^2.8.6"
9  },
10  "devDependencies": {
11    "typescript": "^4.0.5"
12  },
13  "license": "ISC"
14}

注意： 如需添加新依赖，请前往 npm 官方网站查找相应包。

此外，在终端中使用 mkdir 命令创建一个 src 文件夹。所有 TypeScript 文件（.ts）都将存放于此。

编译与运行 TypeScript 文件

可以通过在终端中执行 tsc 命令来编译 TypeScript 文件。部分 IDE 也会自动为你编译 .ts 文件。如果你已将 TypeScript 添加到依赖项中，tsc 命令应在项目中可用。若希望在任何位置都能使用该命令，可通过以下命令全局安装 TypeScript：

1npm install -g typescript

编译 TypeScript 文件后，会生成对应的 .js 文件。你可以使用 node 运行这些生成的文件。请使用下方终端窗口中的以下命令编译并运行提供的 TypeScript 文件：

1tsc
2node main.js

请在下方提供的终端小部件中亲自尝试这些命令。

生成 TypeScript 配置文件

最后，在 /introduction/ 目录下我们会有一个 tsconfig.json 文件。该文件用于告诉 TypeScript 编译目标的 JavaScript 版本、输出路径等信息。对于前几章的内容，默认的 tsconfig.json 文件已足够使用。但请务必确保 tsconfig.json 中的 target 属性不低于 es6。后续章节中，我们将使用 webpack 构建输出，并展示与该配置相匹配的 tsconfig.json。