# @borgar/xlsx-convert 中文文档

规范地址：https://npmcn.com/package/%40borgar/xlsx-convert/

版本：5\.11\.2
npm 元数据更新时间：2026-11-05T14:25:31.110Z
中文译文更新时间：2026-11-08T11:39:32.025Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：2.2 MB，12 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：6 个
- 首次发布：2021-06-30T12:43:48.787Z
- 最新版本发布：2026-11-05T14:25:30.746Z
- 近 30 天下载量：71579（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：53（近 12 个月 30 个）

## 中文简介

将 Excel XLSX 文件转换为 JSON 的工具

## 安装

```sh
npm install @borgar/xlsx-convert
```

也可以使用：`pnpm add @borgar/xlsx-convert`、`yarn add @borgar/xlsx-convert`、`bun add @borgar/xlsx-convert`

## README

# XLSX 转换

这是一个将 Excel XLSX 文件转换为 JSON 格式的工具 。 它只支持 XLSX 文件并输出 JSF, [JSON 电子表格格式](https://github.com/jsfkit/types) (单位:千美元)[见下文](https://npmcn.com/package/%40borgar/xlsx-convert/#readme-output)) (中文(简体) ).

库将在浏览器以及服务器环境中运行(Node, Deno, Bun等).

## 安装

该图书馆还作为国家防范机制的一揽子方案提供:

```
$ npm install @borgar/xlsx-convert
```

## 使用量

```js
// import the converter
import xlsxConvert from '@borgar/xlsx-convert';

// read the file
const jsf = await xlsxConvert('path/to/workbook.xlsx', options);

// emit results
console.log(jsf);
```

这将释放这样的结构:

```js
{
  "filename": "workbook.xlsx",
  "sheets": [
    {
      "cells": {
        "A1": { "v": 12 },
        "B1": { "v": 123.1 },
        "A2": { "v": "Total" },
        "B2": { "v": 135.1, "f": "SUM(A1:B1)", },
      },
      "merges": [],
      "colWidths": [],
      "rowHeights": [],
      "hidden": 0,
      "name": "Sheet1"
    }
  ],
  "names": [],
  "styles": [
    { "font-size": 12 }
  ]
}
```

### [{\\fn方正粗倩简体\\fs12\\an8\\1cHFFFF00\\b0}](https://npmcn.com/package/%40borgar/xlsx-convert/#readme-output) 输出 :

这个 [JSON 电子表格格式](https://jsfkit.github.io/types/) 类似,但与 [CSF结构](https://github.com/SheetJS/sheetjs#common-spreadsheet-format) 用于 [`xlsx` 软件包](https://github.com/SheetJS/sheetjs)。 。 。 .

支持的单元格属性为:

| 细胞. | 说明 |
| --- | --- |
| `v` | 单元格的正确类型值. |
| `f` | 整数索引为R1C1-语法中的公式表达式列表,或A1-语法中的表达式字符串. |
| `F` | 如果公式是数组公式,则附加数组的A1型范围. |
| `c` | 本文后附的评论列表. |
| `s` (可选) | 与单元格相关的样式信息索引. |
| `t` (可选) | 单元格中值的类型(此库仅显示 `"e"` 当值为错误时. |
| `l` (可选) | 带入单元格的 URL . |

只有具有"相关数据"的单元格才会被放出,这在正文中指具有诸如数值,公式,以及与之相接的可见样式等事物的单元格.

## 文档

文档可见于 [文档/](https://npmcn.com/package/%40borgar/xlsx-convert/docs/)数字 :

-   API记录在 [文件/API.md](https://npmcn.com/package/%40borgar/xlsx-convert/docs/API.md)。 。 。 .
-   JSF的产出记录在 [jsfkit.github.io (英语)](https://jsfkit.github.io/types/)。 。 。 .

* * *

@borgar/xlsx-convert的开发由下列单位赞助: [全球资源信息数据库](https://grid.is/),用于AI代理的电子表格引擎.

## 常见问题

### @borgar/xlsx-convert 是什么？

将 Excel XLSX 文件转换为 JSON 的工具

### 如何安装 @borgar/xlsx-convert？

在项目目录运行 npm install @borgar/xlsx-convert，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 xlsx-convert，可以用 npx xlsx-convert 直接运行。

### @borgar/xlsx-convert 支持 TypeScript 吗？

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

### @borgar/xlsx-convert 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @borgar/xlsx-convert 可以商用吗？

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

### @borgar/xlsx-convert 的下载量有多少？

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

### @borgar/xlsx-convert 还在维护吗？

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