# @datalens-tech/xlsx 中文文档

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

版本：0\.20\.3
npm 元数据更新时间：2024-08-09T12:26:36.851Z
中文译文更新时间：2026-11-11T14:48:32.524Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：8.1 MB，26 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=0\.8
- 运行依赖：0 个
- 首次发布：2023-12-22T09:49:00.643Z
- 最新版本发布：2024-08-09T12:26:36.458Z
- 近 30 天下载量：14770（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：3（近 12 个月 0 个）

## 中文简介

PhietJS 电子表格数据解析和写入器

## 安装

```sh
npm install @datalens-tech/xlsx
```

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

## README

# [日记](https://sheetjs.com/)

> 由于原包的作者 [离开 GitHub 和 npm](https://git.sheetjs.com/sheetjs/sheetjs/issues/2667) 使得大多数社区无法在没有 [脆弱性](https://github.com/advisories/GHSA-4r6h-8v6p-xvw6), (中文(简体) ), [https://github.com/e965 (英语)](https://github.com/e965) 决定完成这个项目. 它会自动使用新版本的 SheetJS 从他们的 git 寄存器,如果版本不同,则发布到 npm . 整个过程是自动化的,通过Github Actions工作.
> 
> **为什么是叉子?**  
> 我们创造了叉子 [原始仓库](https://github.com/e965/sheetjs-npm-publisher), (中文(简体) ), 因为我们想控制 出版的图书馆的完整性.

SheetJS社区版为战地测试的开源解决方案提供 从几乎所有复杂的电子表格中提取有用的数据并生成新的 与传统和现代软件一起工作的电子表格.

[日记 Pro](https://sheetjs.com/pro) 提供数据处理以外的解决方案: 轻松地编辑复杂的模板; 以样式放出内部的毕加索; 制作 带有图像/图/关键表格的自定义工作表; 评估公式表达式 端口计算到网络应用程序; 自动化常见的电子表格任务, 还有更多 !

## 文档

-   [API 和使用文档](https://docs.sheetjs.com/)
    
-   [可下载脚本和模块](https://cdn.sheetjs.com/)
    

## 星座

-   [https://oss.sheetjs.com/notes/ 页面存档备份,存于互联网档案馆](https://oss.sheetjs.com/notes/): 文件格式注释
    
-   [`ssf`](https://git.sheetjs.com/sheetjs/sheetjs/src/branch/master/packages/ssf): 使用ECMA-376电子表格格式代码格式数据
    
-   [`xlsx-cli`](https://git.sheetjs.com/sheetjs/sheetjs/src/branch/master/packages/xlsx-cli): 用于处理文件的节点JS命令行工具
    
-   [`cfb`](https://git.sheetjs.com/SheetJS/js-cfb): 集装箱(OLE/ZIP)文件 处理库
    
-   [`codepage`](https://git.sheetjs.com/SheetJS/js-codepage): 遗产文本 xLS 和其他遗留电子表格格式的编码
    
-   [`dta`](https://git.sheetjs.com/sheetjs/sheetjs/src/branch/master/packages/dta): Stata DTA 文件处理器
    
-   [`test_files`](https://github.com/sheetjs/test_files): 测试文件和各种文件 简单文字基线 .
    

## 许可证

详情请查阅所附的LICENSE文件。 所有未明确的权利 由Apache 2.0许可证授予,由原作者保留.

## 常见问题

### @datalens-tech/xlsx 是什么？

PhietJS 电子表格数据解析和写入器

### 如何安装 @datalens-tech/xlsx？

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

### @datalens-tech/xlsx 支持 TypeScript 吗？

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

### @datalens-tech/xlsx 支持 ESM 还是 CommonJS？

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

### @datalens-tech/xlsx 需要什么版本的 Node\.js？

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

### @datalens-tech/xlsx 可以商用吗？

@datalens-tech/xlsx 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @datalens-tech/xlsx 的下载量有多少？

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

### @datalens-tech/xlsx 还在维护吗？

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