Node.JS 中的逐步 XLS 转 CSV 转换

将 Excel 数据转换为 CSV 是在构建数据管道、报告工具或导入/导出功能时的常见需求。 Aspose.BarCode Cloud SDK for Node.js 提供了一个强大的库，使得在 Node.JS 中将 XLS 转换为 CSV 变得简单可靠。本指南将带您了解前提条件、安装步骤、完整的工作示例以及最佳实践技巧，帮助您自信地将转换集成到应用程序中。

完整的 XLS 转 CSV 转换示例（Node.JS 使用 Aspose.BarCode）

此示例演示如何从云存储读取 XLS 工作簿，将每个工作表转换为 CSV，并将结果流式传输回客户端。

// Full working code for XLS to CSV conversion using Aspose.BarCode Cloud SDK

const { BarcodeApi, Configuration } = require('aspose-barcode-cloud');
const fs = require('fs');
const path = require('path');

// ==== Configuration ====
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET",
    // Optional: set a custom base URL if you use a private cloud
    // baseUrl: "https://api.aspose.cloud"
});

const apiInstance = new BarcodeApi(config);

// ==== Input / Output Paths ====
const inputFile = "sample.xls";               // Path to your local XLS file
const outputFolder = "output";                // Cloud folder for CSV files

// ---- 1. Upload XLS to cloud storage ----
async function uploadFile() {
    const fileData = fs.readFileSync(inputFile);
    await apiInstance.uploadFile({ path: inputFile, file: fileData });
    console.log(`Uploaded ${inputFile} to cloud storage.`);
}

// ---- 2. Convert XLS to CSV ----
async function convertXlsToCsv() {
    // Conversion options
    const options = {
        storage: "Default",               // Use default storage
        outPath: outputFolder,            // Destination folder
        format: "CSV",                    // Target format
        // Optional: delimiter, encoding, etc.
        delimiter: ",",
        encoding: "UTF-8"
    };

// Call the conversion endpoint (hypothetical method)
    const response = await apiInstance.convertDocument({
        name: inputFile,
        format: "csv",
        options: options
    });

console.log(`Conversion started. Check ${outputFolder} for CSV files.`);
    return response;
}

// ---- 3. Download generated CSV files ----
async function downloadCsvFiles() {
    const files = await apiInstance.getFilesList({ path: outputFolder });
    for (const file of files.value) {
        if (file.name.endsWith(".csv")) {
            const csvData = await apiInstance.downloadFile({ path: `${outputFolder}/${file.name}` });
            const localPath = path.join(__dirname, "result", file.name);
            fs.mkdirSync(path.dirname(localPath), { recursive: true });
            fs.writeFileSync(localPath, csvData.body);
            console.log(`Downloaded ${file.name} to ${localPath}`);
        }
    }
}

// ==== Execution Flow ====
(async () => {
    try {
        await uploadFile();
        await convertXlsToCsv();
        await downloadCsvFiles();
        console.log("XLS to CSV conversion completed successfully.");
    } catch (error) {
        console.error("Error during conversion:", error);
    }
})();

注意： 此代码示例演示了核心功能。在将其用于项目之前，请确保更新文件路径（sample.xls、output），验证所有必需的依赖项已正确安装，并在开发环境中彻底测试。如果遇到任何问题，请参考官方文档或联系支持团队获取帮助。

使用 cURL 的云 API 将 XLS 转换为 CSV

您可以通过使用 cURL 调用 REST 接口，在不编写代码的情况下执行相同的转换。整个流程包括身份验证、文件上传、转换请求和下载。

# 1. Get an access token
curl -X POST "https://api.aspose.cloud/connect/token" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET" \
     -H "Content-Type: application/x-www-form-urlencoded"
# Response contains "access_token"

# 2. Upload the XLS file
curl -X PUT "https://api.aspose.cloud/v3.0/barcode/storage/file/sample.xls" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "sample.xls"

# 3. Request XLS to CSV conversion
curl -X POST "https://api.aspose.cloud/v3.0/barcode/convert/sample.xls?format=csv&outPath=output" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Download the generated CSV file
curl -X GET "https://api.aspose.cloud/v3.0/barcode/storage/file/output/sample.csv" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" -o "sample.csv"

有关请求参数的更多详细信息，请参阅官方 API 文档。

在 Node.JS 中将 XLS 转换为 CSV 的工作原理

配置设置 - Configuration 对象保存您的客户端凭据和可选的基础 URL。该对象传递给 BarcodeApi 实例。
```
const config = new Configuration({ clientId, clientSecret });
const apiInstance = new BarcodeApi(config);
```
文件上传 - uploadFile 方法将本地 XLS 文件流式传输到 Aspose.BarCode 云存储，使其可用于转换。
```
await apiInstance.uploadFile({ path: inputFile, file: fileData });
```
转换调用 - convertDocument（假设的）发送请求，包含源文件名、目标格式（csv）以及诸如分隔符和编码等转换选项。服务会处理每个工作表并创建相应的 CSV 文件。
```
const response = await apiInstance.convertDocument({ name: inputFile, format: "csv", options });
```
结果检索 - 转换完成后，getFilesList 列出输出文件夹中生成的 CSV 文件。然后使用 downloadFile 下载每个文件并保存到本地。
```
const files = await apiInstance.getFilesList({ path: outputFolder });
const csvData = await apiInstance.downloadFile({ path: csvPath });
```
错误处理 - 任何 API 错误都会在 catch 块中捕获，您可以记录详细信息或实现重试逻辑。有关错误代码的完整列表，请参阅 API 参考。

环境准备 - 前提条件和设置

在开始之前，请确保满足以下前提条件：

在开发机器上安装了 Node.js 14 或更高版本。
拥有有效客户端凭据（Client ID 和 Client Secret）的 Aspose Cloud 账户。
访问互联网以进行 API 调用。

通过 npm 安装库，并链接下载页面以供参考：

npm install aspose-barcode-cloud
# Download package details: https://releases.aspose.cloud/barcode/nodejs/

安装完成后，创建一个配置文件（例如 config.json），安全地存储您的凭据。

转换参数：选项和设置

转换 API 接受多个可选参数，允许您对输出进行微调：

delimiter - 选择用于分隔字段的字符（默认是 ,）。
```
options.delimiter = "\t"; // Tab‑delimited CSV
```
encoding - 为 CSV 文件定义字符编码（例如 UTF-8、ISO-8859-1）。
```
options.encoding = "UTF-8";
```
outPath - 指定存放 CSV 文件的云文件夹。
```
options.outPath = "converted";
```
storage - 如果使用自定义存储服务，选择存储名称。
```
options.storage = "MyCustomStorage";
```

要查看受支持选项的完整列表，请参阅 API 参考。

高效 XLS 转 CSV 转换的实用技巧

流式处理大文件 - 启用流模式，以块方式处理行，避免高内存消耗。
使用临时文件夹 - 将中间 CSV 文件写入专用的云文件夹，下载后进行清理。
设置合适的分隔符 - 如果数据中包含逗号，请切换为制表符或管道符分隔，以防列错位。
下载后验证 - 在进一步处理之前，检查 CSV 的前几行，以确保编码和分隔符使用正确。

结论

XLS 到 CSV 的转换在 Node.JS 中变得简单，只要利用 Aspose.BarCode Cloud SDK for Node.js 的功能。本指南涵盖了从环境设置、完整示例到配置选项和面向性能的最佳实践。请记住要保护您的客户端凭据，针对大型工作簿选择流式处理，并清理临时文件以保持云存储整洁。对于生产部署，您需要付费许可证；您可以在产品页面查看定价，并从临时许可证页面获取临时评估许可证。

常见问题

Node.JS 中的 XLS 转 CSV 转换如何处理多个工作表？
库会顺序处理每个工作表，为每个工作表生成单独的 CSV 文件。如果需要单个 CSV，您可以随后将它们合并。有关详细用法，请参阅 Aspose.BarCode Cloud SDK for Node.js。

我可以在不将整个工作簿加载到内存中的情况下，将大型 XLS 文件流式传输为 CSV 吗？
可以。通过在转换参数中启用流式选项，API 会以可管理的块读取行，从而保持低内存使用并提升性能。

在生产环境中使用 Aspose.BarCode Cloud SDK for Node.js 需要什么许可证？
生产使用需要商业许可证。购买选项列在产品定价页面，您可以从临时许可证页面请求临时评估许可证。

是否可以在转换期间自定义 CSV 分隔符？
当然。在转换参数中设置 delimiter 选项为您需要的任意字符，例如制表符（\t）或管道符（|）。这可确保生成的 CSV 符合下游处理的预期。

完整的 XLS 转 CSV 转换示例（Node.JS 使用 Aspose.BarCode）#

使用 cURL 的云 API 将 XLS 转换为 CSV#

在 Node.JS 中将 XLS 转换为 CSV 的工作原理#

环境准备 - 前提条件和设置#

转换参数：选项和设置#

高效 XLS 转 CSV 转换的实用技巧#

结论#

常见问题#

阅读更多#