# @aternus/csv-to-xlsx 中文文档

规范地址：https://npmcn.com/package/%40aternus/csv-to-xlsx/

版本：3\.0\.5
npm 元数据更新时间：2025-10-26T08:38:10.251Z
中文译文更新时间：2026-11-07T01:55:41.962Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：15 kB，10 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：3 个
- 首次发布：2018-09-17T21:21:43.397Z
- 最新版本发布：2025-10-26T08:38:10.051Z
- 近 30 天下载量：10313（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：41（近 12 个月 0 个）

## 中文简介

通过Node.js CLI或API将CSV文件转换为XLSX(Excel 2007+XML格式)文件.

## 安装

```sh
npm install @aternus/csv-to-xlsx
```

也可以使用：`pnpm add @aternus/csv-to-xlsx`、`yarn add @aternus/csv-to-xlsx`、`bun add @aternus/csv-to-xlsx`

## README

# @ aternus/csv-to-xlsx (英语)

[![version on npm](https://img.shields.io/npm/v/@aternus/csv-to-xlsx?logo=npm&color=CB3836)](https://www.npmjs.com/package/@aternus/csv-to-xlsx) [![version on GitHub](https://img.shields.io/github/v/release/Aternus/csv-to-xlsx?logo=github&sort=semver)](https://github.com/Aternus/csv-to-xlsx/releases) [![required node version](https://img.shields.io/node/v/@aternus/csv-to-xlsx?logo=nodedotjs)](https://www.npmjs.com/package/@aternus/csv-to-xlsx) [![license](https://img.shields.io/npm/l/@aternus/csv-to-xlsx)](https://npmcn.com/package/%40aternus/csv-to-xlsx/LICENSE.md) [![npm downloads](https://img.shields.io/npm/dm/@aternus/csv-to-xlsx)](https://www.npmjs.com/package/@aternus/csv-to-xlsx)

将 CSV 文件转换为 XLSX (Excel 2007+ XML Format) 文件.

以 JavaScript 编写 。 可用于Node.js CLI和API.

二进制有:

-   视窗 x64
-   Linux x64 函数
-   macOS x64

[![validate](https://github.com/Aternus/csv-to-xlsx/actions/workflows/validate.yml/badge.svg?branch=master)](https://github.com/Aternus/csv-to-xlsx/actions/workflows/validate.yml)

自信地安装

## 特征

-   二进制:通过您的 OS 命令行工具下载和运行
-   快速而可靠
-   UTF-8 完整支持
-   CSV 列检测
-   批量模式: 将 CSV 文件夹转换为 XLSX 文件夹
-   节点.js CLI 和 API

## 安装

```shell
npm install @aternus/csv-to-xlsx
```

## 使用量

### 二进制

从中下载可执行文件 [最新发布](https://github.com/Aternus/csv-to-xlsx/releases)。 。 。 .

```shell
./csv-to-xlsx-linux -i "input-file-or-directory" -o "output-directory"
```

确保只使用项目提供的二进制, [安全使用二进制(如何避免病毒)](https://npmcn.com/package/%40aternus/csv-to-xlsx/#readme-safe-use-of-binaries)。 。 。 .

### 节点.js CLI

类型 `--help` 用于完整选项清单.

```shell
npx @aternus/csv-to-xlsx -i "input-file-or-directory" -o "output-directory"
```

### 节点.js API

```javascript
const path = require('path');
const {convertCsvToXlsx} = require('@aternus/csv-to-xlsx');

let source = path.join(__dirname, 'report.csv');
let destination = path.join(__dirname, 'converted_report.xlsx');

try {
  convertCsvToXlsx(source, destination);
} catch (e) {
  console.error(e.toString());
}
```

## 二进制的安全使用

该项目的目标之一是允许运行 CSV 到 XLSX 工具直接打开 你的电脑.

创建目录, 将可执行文件放入目录内, 创建一个 `csv` 文件夹 简历和 `xlsx` 文件夹将包含已转换的文件; plain 而且很简单,你甚至不用使用终端(CLI).

为了实现这一目标,我们把所有的代码都装入一个 单文件,称为二进制. 这个二进制有好几个部件,一个节点.js 运行时间和该工具的源代码.

不幸的是,这个 [导致一些抗病毒程序将其标为特洛伊](https://www.virustotal.com/gui/file/d6de800058997cb8dcb74eb4ce6125fb71d3169bbef7400b0e06fd99fd24008a/detection)。 。 。 . 这是一个 [已知问题](https://github.com/yao-pkg/pkg/issues/167) 并且应该 当Node.js 船体具有内置模式时固定 [生成单个可执行应用程序](https://nodejs.org/api/single-executable-applications.html)。 。 。 .

在此之前, **请确保您下载二进制 [csv- to- xlsx 的释放页面](https://github.com/Aternus/csv-to-xlsx/releases)**。 。 。 .

如果你对可执行文件的来源有疑问,你可以检查 `sha256` 以释放资产中指定的可执行文件.

### 检查中 `sha256` 二进制

macOS / Linux 系统

```shell
shasum -a 256 ./csv-to-xlsx-macos
```

窗口 :

```shell
certutil -hashfile .\csv-to-xlsx-win.exe SHA256
```

### macOS: 如何运行 csv- to- xlsx

[csv-to-xlsx 二进制 - macOS.webm](https://github.com/user-attachments/assets/cca82667-f779-4e4a-88fb-b130328b8667)

### 视窗:如何运行 Csv- to- xlsx

[csv- to-xlsx 二进制 - 窗口.webm](https://github.com/user-attachments/assets/24a73c20-50dd-4c5c-97ce-03e81ab80bbf)

## 许可证

根据麻省理工学院的许可获释----见 `LICENSE.md` 详细情况.

## 常见问题

### @aternus/csv-to-xlsx 是什么？

通过Node\.js CLI或API将CSV文件转换为XLSX\(Excel 2007\+XML格式\)文件\.

### 如何安装 @aternus/csv-to-xlsx？

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

### @aternus/csv-to-xlsx 支持 TypeScript 吗？

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

### @aternus/csv-to-xlsx 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @aternus/csv-to-xlsx 需要什么版本的 Node\.js？

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

### @aternus/csv-to-xlsx 可以商用吗？

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

### @aternus/csv-to-xlsx 的下载量有多少？

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

### @aternus/csv-to-xlsx 还在维护吗？

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