从零开始搭建一个TypeScript项目，只需遵循以下步骤：搭建开发环境、创建项目目录、安装依赖、配置tsconfig.json、编写代码与测试。

项目 2026-07-31 0°

搭建一个TypeScript项目可能看起来有点复杂，但其实只要按照以下步骤一步步来，你会发现它非常简单。下面，我将详细地介绍如何从零开始搭建一个TypeScript项目，包括搭建开发环境、创建项目目录、安装依赖、配置tsconfig.json、编写代码与测试。

搭建开发环境

在开始之前，确保你的电脑上安装了Node.js和npm（Node.js包管理器）。你可以从Node.js官网下载并安装。

打开终端或命令提示符。
输入以下命令检查Node.js和npm的版本：
```
node -v
npm -v
```
如果版本号显示正常，说明你的开发环境已经搭建好了。

创建项目目录

打开终端或命令提示符。
使用mkdir命令创建一个新的文件夹，例如typescript-project：
```
mkdir typescript-project
```
切换到新创建的文件夹：
```
cd typescript-project
```

安装依赖

使用npm初始化项目：
```
npm init -y
```
这条命令会创建一个package.json文件，并自动填充一些默认值。
安装TypeScript：
```
npm install typescript --save-dev
```
这条命令会将TypeScript添加到项目的devDependencies中，并安装相关依赖。

配置tsconfig.json

在项目根目录下，创建一个名为tsconfig.json的文件。
使用以下内容作为tsconfig.json的初始配置：
```
{
 "compilerOptions": {
   "target": "es5",
   "module": "commonjs",
   "strict": true,
   "esModuleInterop": true
 }
}
```
这个配置文件定义了TypeScript编译器的选项，例如目标JavaScript版本、模块系统、严格模式等。

编写代码与测试

现在，你已经搭建好了一个基本的TypeScript项目，接下来我们可以开始编写代码了。

在项目根目录下创建一个名为src的文件夹，用于存放TypeScript源代码。
在src文件夹中创建一个名为index.ts的文件，并编写一些TypeScript代码。例如，我们可以创建一个简单的加法函数： “`typescript // src/index.ts function add(a: number, b: number): number { return a + b; }

console.log(add(1, 2)); // 输出：3

3. 在项目根目录下创建一个名为`test`的文件夹，用于存放测试代码。
4. 在`test`文件夹中创建一个名为`index.test.ts`的文件，并编写测试代码。例如，我们可以编写一个测试用例来测试我们之前创建的加法函数：
   ```typescript
   // test/index.test.ts
   import { add } from '../src/index';

   describe('add function', () => {
     it('should add two numbers', () => {
       expect(add(1, 2)).toBe(3);
     });
   });

使用npm运行测试：
```
npm test
```
这条命令会使用Jest测试框架运行测试用例。

现在，你已经成功搭建了一个TypeScript项目，并编写了一个简单的加法函数以及相应的测试用例。你可以继续添加更多的功能、编写更多的测试用例，并优化你的项目。