SheetJS 安装

注意，https://cdn.sheetjs.com 是 SheetJS 主要的软件分发网站。

下面将介绍多种安装 SheetJS 的方法。

浏览器<script>方式

SheetJS 的每个独立发布脚本都可在 https://cdn.sheetjs.com/ 站点获取。

当前版本是 0.20.3，可按以下方式引用：

<!-- 使用版本 0.20.3 -->
<script type="text/javascript" src="https://cdn.sheetjs.com/xlsx-0.20.3/package/dist/xlsx.full.min.js"></script>

注意，上面引入的是全量 xlsx.full.min.js 脚本（功能完整，但体积更大，如果网速不好，加载会慢一点），它支持读取和写入多种电子表格格式。

如果为了轻便（体积更小，加载更快），可以安装精简版脚本：

<!-- 使用版本0.20.3中的xlsx.mini.min.js -->
<script type="text/javascript" src="https://cdn.sheetjs.com/xlsx-0.20.3/package/dist/xlsx.mini.min.js"></script>

xlsx.mini.min.js 是一个精简版本，它省略了以下功能：

• CSV 和 SYLK 编码（直接影响美国以外的用户）

• XLSB / XLS / Lotus 1-2-3 / SpreadsheetML 2003 / Apple Numbers 文件格式

• 流实用函数

注意，为了保证整体稳定性，强烈建议将 SheetJS 脚本下载到本地，放到项目的指定目录。

• 下载所需版本的脚本（xlsx.full.min.js）。当前版本可在 https://cdn.sheetjs.com/xlsx-0.20.3/package/dist/xlsx.full.min.js 获取。

• 将该脚本移至包含其他脚本的 public 文件夹中。

• 从 HTML 页面引用该本地化脚本：

<script src="/public/xlsx.full.min.js"></script>

注意，此脚本赋值给 window.XLSX。该全局变量可在其他脚本中使用。

Internet Explorer 和旧版浏览器

为了与各种 JavaScript 引擎广泛兼容，该库使用 ECMAScript 3 语言方言编写。一个“shim”脚本为较旧的浏览器和环境提供了函数实现。

由于 SSL 兼容性问题，旧版本的 IE 将无法直接使用 CDN 脚本。应将这些脚本下载并保存到公共路径：

• SheetJS: https://cdn.sheetjs.com/xlsx-0.20.3/package/dist/xlsx.mini.min.js

• Shim: https://cdn.sheetjs.com/xlsx-0.20.3/package/dist/shim.min.js

注意，对 shim 脚本的 <script> 引用必须添加在 SheetJS 之前：

<!-- 先添加 shim 脚本 -->
<script type="text/javascript" src="shim.min.js"></script>
<!-- 在引用 shim 脚本后，添加该库 -->
<script type="text/javascript" src="xlsx.full.min.js"></script>

公共广告位-前端

框架和打包工具方式

每个独立的发布包都可在 https://cdn.sheetjs.com/ 获取。NodeJS 包旨在与框架和打包工具配合使用。它是一个合适的 ECMAScript 模块版本，可通过开发工具进行优化。

https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz 是 0.20.3 版本的网址。

可以使用包管理器直接安装 tar 包：

• npm 工具

npm rm --save xlsx
npm i --save https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz

安装后，该库可以使用名称 xlsx 导入：

import { read, writeFileXLSX } from "xlsx";

• pnpm 工具

pnpm rm xlsx
pnpm install --save https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz

安装后，该库可以以 xlsx 为名导入：

import { read, writeFileXLSX } from "xlsx";

• yarn 工具

yarn remove xlsx
yarn add https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz

注意，Yarn 的较新版本可能会抛出错误：

Usage Error: It seems you are trying to add a package using a https:... url; we now require package names to be explicitly specified.
Try running the command again with the package name prefixed: yarn add my-package@https:...

解决方法是在 URL 前加上 xlsx@：

yarn add xlsx@https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz

安装后，该库可以用名称xlsx导入：

import { read, writeFileXLSX } from "xlsx";

NodeJS 方式

包压缩文件可在 https://cdn.sheetjs.com 获取。

https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz 是 0.20.3 版本的网址。

可以使用包管理器直接安装tar包：

• npm 工具

npm rm --save xlsx
npm i --save https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz

• pnpm 工具

pnpm rm xlsx
pnpm install --save https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz

• yarn 工具

yarn remove xlsx
yarn add https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz

注意，Yarn 的较新版本可能会抛出错误：

Usage Error: It seems you are trying to add a package using a https:... url; we now require package names to be explicitly specified.
Try running the command again with the package name prefixed: yarn add my-package@https:...

解决方法是在 URL 前加上 xlsx@：

yarn add xlsx@https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz

更多安装方式参考 https://docs.sheetjs.com/docs/getting-started/installation/ 页面。