# @file-type/cfbf 中文文档

规范地址：https://npmcn.com/package/%40file-type/cfbf/

版本：0\.2\.2
npm 元数据更新时间：2026-10-24T11:54:31.062Z
中文译文更新时间：2026-11-14T17:37:42.473Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40file-type/cfbf
原文对照：https://npmcn.com/package/%40file-type/cfbf/?lang=original
项目主页：https://github.com/Borewit/file-type-cfbf#readme
源码仓库：https://github.com/Borewit/file-type-cfbf

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：14.2 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2026-01-08T11:06:24.502Z
- 最新版本发布：2026-01-24T18:53:47.415Z
- 近 30 天下载量：92202（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：5（近 12 个月 5 个）

## 中文简介

文件类型的复合文件二进制格式( CFBF) 检测插件

## 安装

```sh
npm install @file-type/cfbf
```

也可以使用：`pnpm add @file-type/cfbf`、`yarn add @file-type/cfbf`、`bun add @file-type/cfbf`

## README

[![NPM version](https://img.shields.io/npm/v/@file-type/cfbf.svg)](https://npmjs.org/package/@file-type/cfbf) [![Node.js CI](https://github.com/Borewit/file-type-cfbf/actions/workflows/nodejs-ci.yml/badge.svg)](https://github.com/Borewit/file-type-cfbf/actions/workflows/nodejs-ci.yml) [![npm downloads](http://img.shields.io/npm/dm/@file-type/cfbf.svg)](https://npmcharts.com/compare/@file-type/cfbf?start=365)

# @ 文件类型/ cfbf

探测器插件 [文件类型](https://github.com/sindresorhus/file-type) 以 [复合文件二进制格式](https://en.wikipedia.org/wiki/Compound_File_Binary_Format), (中文(简体) ), 一般称为CFBF或OLE化合物文档.

CFBF是许多遗留Microsoft Office文件和其他Windows应用程序使用的容器格式. 此插件可以检测容器本身,而不是其内部的特定文档内容.

## 安装

```bash
npm install @file-type/cfbf
```

## 使用量

以下例子说明如何将CFBF探测器添加到 [文件类型](https://github.com/sindresorhus/file-type)。 。 。 .

```js
import {FileTypeParser} from 'file-type';
import {detectCfbf} from '@file-type/cfbf';

const parser = new FileTypeParser({customDetectors: [detectCfbf]});
const fileType = await parser.fromFile('smaple.doc');
console.log(fileType);
```

## 支持文件格式

此检测器可识别使用 : [复合文件二进制格式](https://en.wikipedia.org/wiki/Compound_File_Binary_Format) 格式容器 :

### Microsoft 办公室遗留格式

这些是办公室前的 Open XML 二进制 Office 格式(CFBF/OLE), 微软Office在Office 2007之前使用:

-   `.doc` 微软Word文件(Word 6.0/95,Word 97-2003)
-   `.pub` 微软出版社文件(Publisher 3.0/95- 4.0/97,出版社 5.0/98)
-   `.ppt` 微软PowerPoint演示(PowerPoint 4.0, 7.0/95, 97-2003)
-   `.vsd` 微软Visio绘图(2000-2002年,2003-2010年)
-   `.wps` Microsoft Works 7–9 Word 处理器文档
-   `.xls` 微软Excel电子表格(Excel 5.0/95,Excel 97-2003)

其他文件 :

-   `.msi` [窗口安装器文件](https://en.wikipedia.org/wiki/Windows_Installer)

## 许可证

本项目根据以下规定获得许可证: [MIT 许可证](https://npmcn.com/package/%40file-type/cfbf/LICENSE.txt). 随意使用、修改和按需要分发.

## 常见问题

### @file-type/cfbf 是什么？

文件类型的复合文件二进制格式\( CFBF\) 检测插件

### 如何安装 @file-type/cfbf？

在项目目录运行 npm install @file-type/cfbf，或使用 pnpm add / yarn add / bun add。

### @file-type/cfbf 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @file-type/cfbf 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @file-type/cfbf 可以商用吗？

@file-type/cfbf 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @file-type/cfbf 的下载量有多少？

根据 npm 官方下载统计，@file-type/cfbf 在 2026/10/15 – 2026/11/13 这 30 天内被下载 92,202 次，日均约 3,073 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @file-type/cfbf 还在维护吗？

最新版本 0\.2\.2 发布于 2026/01/25（9 个月前）；至今共发布 5 个版本，其中过去 12 个月发布了 5 个；首次发布于 2026/01/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。