vite-plugin-istanbul 的安装和配置教程

2025-05-24 13:38:50作者：丁柯新Fawn

项目基础介绍

vite-plugin-istanbul 是一个为 Vite 开发环境设计的插件，用于代码覆盖率的测量。它通过在代码中插入额外的语句来跟踪测试覆盖率，与 Istanbul（现在是 nyc）工具兼容。这个插件主要使用 TypeScript 和 JavaScript 编写。

项目使用的关键技术和框架

本项目依赖于以下几个关键技术：

Vite：一个现代化的前端构建工具，用于构建大型前端项目。
Istanbul/nyc：一个代码覆盖率检测工具，用于跟踪测试中哪些代码被覆盖到。
Babel：一个广泛使用的 JavaScript 转译器，用于将 ES6+ 代码转换为向后兼容的 JavaScript 版本。

项目安装和配置的准备工作

在开始安装 vite-plugin-istanbul 之前，确保您的系统中已经安装了以下依赖项：

Node.js（推荐使用 LTS 版本）
npm 或 yarn（推荐使用 yarn）

安装步骤

克隆项目

首先，您需要克隆项目到本地开发环境。在命令行中执行以下命令：
```
git clone https://github.com/iFaxity/vite-plugin-istanbul.git
```
安装依赖

进入项目目录后，安装项目依赖：
```
cd vite-plugin-istanbul
yarn install
```
或者如果您使用 npm：
```
npm install
```
配置 Vite

在您的 Vite 项目中，您需要配置 Vite 以使用 vite-plugin-istanbul。首先，安装插件：
```
yarn add -D vite-plugin-istanbul
```
或者使用 npm：
```
npm i -D vite-plugin-istanbul
```

修改 Vite 配置文件

在您的 vite.config.js 文件中，引入并使用 vite-plugin-istanbul：

import { defineConfig } from 'vite';
import istanbul from 'vite-plugin-istanbul';

export default defineConfig({
  plugins: [
    istanbul({
      include: 'src/*',
      exclude: ['node_modules', 'test/'],
      extension: ['.js', '.ts', '.vue'],
      requireEnv: true,
    }),
  ],
  // 其他配置...
});

运行测试并检查覆盖率

确保在环境变量中设置了 VITE_COVERAGE=true，然后运行您的测试套件。插件将自动收集覆盖率信息。
```
VITE_COVERAGE=true yarn test
```
或者使用 npm：
```
VITE_COVERAGE=true npm test
```