# @agile-team/mach-table-xlsx 中文文档

规范地址：https://npmcn.com/package/%40agile-team/mach-table-xlsx/

版本：0\.38\.0
npm 元数据更新时间：2026-11-05T03:07:23.205Z
中文译文更新时间：2026-11-06T16:15:02.540Z
软件包许可：SEE LICENSE IN LICENSE

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

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

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

- 包体积（解压后）：22.3 kB，7 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=18\.0\.0
- 运行依赖：1 个
- 首次发布：2026-08-29T13:16:17.531Z
- 最新版本发布：2026-11-05T03:07:23.021Z
- 近 30 天下载量：2762（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：31（近 12 个月 31 个）

## 中文简介

可选的引擎不可识别 XLSX 导入和导出MachTable扩展

## 安装

```sh
npm install @agile-team/mach-table-xlsx
```

也可以使用：`pnpm add @agile-team/mach-table-xlsx`、`yarn add @agile-team/mach-table-xlsx`、`bun add @agile-team/mach-table-xlsx`

## README

![MachTable](https://raw.githubusercontent.com/ChenyCHENYU/MachTable/main/assets/mach-table-logo.svg)

# @agile-team/mach-table-xlsx

MachTable 0.38.0 的可选 XLSX 导入导出扩展。工作簿引擎由宿主动态注入，因此普通表格页面不会下载 Excel 代码。

```bash
pnpm add @agile-team/mach-table-xlsx xlsx
```

```ts
import { createXlsxExtension } from "@agile-team/mach-table-xlsx";

const excel = createXlsxExtension(() => import("xlsx"));

await excel.export(api, {
  fileName: "orders.xlsx",
  sheetName: "Orders"
});

await excel.import(api, await file.arrayBuffer(), {
  sheet: 0,
  mode: "replace",
  coerceNumbers: true
});
```

0.34.0 与 Core/Vue/React 固定版本组同步发布。默认导出通过 `io.exportMatrix({ target: "xlsx" })`，默认导入使用原始单元格和 `cellDates: true`；数值、布尔、Date 与长标识无需格式化 CSV 往返。已有 `transformCell` / `parseValue` 字符串回调仅在显式配置时执行。需要整批业务校验和可审阅预览时，先读取矩阵并使用 Core/Vue/React 的可选 `/import` 计划。直接导入的 replace/append 同步装载经 parser 规范化的记录，不运行交互校验；paste 复用交互校验与撤销管线，boolean 不代表异步校验完成。

导出展示通过列的通用 `valueSerializer({ value, target })` 显式配置，XLSX 通道使用 `target === "xlsx"`；默认保留原值及类型。标签、枚举与其他异步数据由项目准备后再执行导出，扩展不接入数据插件或专用字典协议。

扩展复用 Core 的选择范围、表头、公式注入防护和安全导入规则。`xlsx` 只是示例引擎，不是本包的捆绑依赖；可注入经过项目批准的兼容引擎。

文档：[XLSX 指南](https://github.com/ChenyCHENYU/MachTable/blob/main/docs/recipes/xlsx.md) · [企业接入](https://github.com/ChenyCHENYU/MachTable/blob/main/docs/guide/enterprise-integration.md)

Source-available © ChenyCHENYU (Agile Team). 任何使用均须事先取得书面授权。详见 [LICENSE](https://github.com/ChenyCHENYU/MachTable/blob/main/LICENSE) 与[授权流程](https://github.com/ChenyCHENYU/MachTable/blob/main/LICENSING.md)。

## 常见问题

### @agile-team/mach-table-xlsx 是什么？

可选的引擎不可识别 XLSX 导入和导出MachTable扩展

### 如何安装 @agile-team/mach-table-xlsx？

在项目目录运行 npm install @agile-team/mach-table-xlsx，或使用 pnpm add / yarn add / bun add。

### @agile-team/mach-table-xlsx 支持 TypeScript 吗？

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

### @agile-team/mach-table-xlsx 支持 ESM 还是 CommonJS？

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

### @agile-team/mach-table-xlsx 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @agile-team/mach-table-xlsx 可以商用吗？

@agile-team/mach-table-xlsx 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @agile-team/mach-table-xlsx 的下载量有多少？

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

### @agile-team/mach-table-xlsx 还在维护吗？

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