Bili 项目使用教程

1. 项目介绍

Bili 是一个用于简化 JavaScript 库打包的工具。它基于 Rollup 构建，旨在提供零配置的快速打包体验。Bili 支持多种 JavaScript 转换工具，如 Buble、Babel 和 TypeScript，并且内置了对 CSS、Sass、Stylus 和 Less 的支持。此外，Bili 还提供了友好的错误日志记录和 TypeScript 编写的 API 文档。

2. 项目快速启动

安装 Bili

首先，你需要在你的项目中安装 Bili。你可以使用 npm 或 yarn 进行安装：

npm install bili --save-dev
# 或者使用 yarn
yarn add bili --dev

创建配置文件

虽然 Bili 支持零配置，但你也可以创建一个 bili.config.js 文件来自定义打包选项：

// bili.config.js
module.exports = {
  input: 'src/index.js', // 入口文件
  output: {
    format: ['cjs', 'esm'], // 输出格式
    dir: 'dist' // 输出目录
  }
};

运行 Bili

在你的项目根目录下运行以下命令来打包你的 JavaScript 库：

npx bili
# 或者使用 yarn
yarn bili

打包完成后，你会在 dist 目录下看到生成的文件。

3. 应用案例和最佳实践

应用案例

假设你正在开发一个 JavaScript 库，并且希望将其打包为 CommonJS 和 ES 模块格式。你可以使用 Bili 来简化这个过程。以下是一个简单的示例：

// src/index.js
export function greet(name) {
  return `Hello, ${name}!`;
}

通过运行 npx bili，Bili 会自动将 src/index.js 打包为 dist/index.cjs.js 和 dist/index.esm.js。

最佳实践

• 使用 TypeScript：如果你使用 TypeScript，Bili 会自动处理 TypeScript 文件并生成相应的类型声明文件。
• 自定义 Rollup 插件：Bili 允许你轻松集成 Rollup 插件，以满足特定的打包需求。
• 优化输出：通过配置 output 选项，你可以控制输出的文件格式和目录结构，以适应不同的发布需求。

4. 典型生态项目

Bili 作为一个打包工具，通常与其他前端开发工具链结合使用。以下是一些典型的生态项目：

• Rollup：Bili 基于 Rollup 构建，因此你可以使用 Rollup 的插件和配置来扩展 Bili 的功能。
• Babel：Bili 支持 Babel 转换，允许你在打包过程中使用最新的 JavaScript 特性。
• TypeScript：Bili 内置了对 TypeScript 的支持，可以自动处理 .ts 文件并生成类型声明文件。
• ESLint：在打包之前，你可以使用 ESLint 来检查代码质量，确保代码符合规范。

通过结合这些工具，你可以构建一个高效且功能强大的前端开发环境。