Aspose.Cells FOSS
TypeScript
Getting Started
Quickstart

Quickstart

本指南逐步演示面向 TypeScript 的核心 Aspose.Cells FOSS 工作流：从头创建工作簿、加载已有的 XLSX 文件、对单元格进行样式设置以及将数据导出为其他格式。下面的每个章节都是独立示例，构建完库后即可复制到 Node.js 项目中使用。

创建工作簿

创建一个新的 Workbook，使用 worksheet.putValue() 将类型化的值（字符串和数字）写入单元格，并将结果保存为 XLSX 文件：

import { Workbook } from "excel-cells";

const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;

worksheet.putValue("A1", "Product");
worksheet.putValue("B1", "Revenue");
worksheet.putValue("A2", "Widget");
worksheet.putValue("B2", 42000);
worksheet.putValue("A3", "Gadget");
worksheet.putValue("B3", 31500);

await workbook.save("report.xlsx");

加载已有工作簿

使用 Workbook.load() 打开已有的 XLSX 文件，然后使用 worksheet.getCell() 读取单元格的值。这是读取其他工具生成的电子表格数据的典型入口：

import { Workbook } from "excel-cells";

const workbook = await Workbook.load("report.xlsx");
const worksheet = workbook.worksheets[0]!;

const product = worksheet.getCell(0, 0)?.value;
const revenue = worksheet.getCell(0, 1)?.value;
console.log(`${product}: ${revenue}`);

应用样式

创建一个 Style 对象并设置字体属性——名称、大小、粗体和颜色——随后使用 cell.setStyle() 将其分配给单元格。样式是独立的对象，因此同一个 Style 实例可以在多个单元格之间复用：

import { Workbook, Style } from "excel-cells";

const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;

const style = new Style();
style.setFontName("Arial");
style.setFontSize(14);
style.setBold(true);
style.setFontColor("FF0000");

const cell = worksheet.getCell2("A1");
cell.putValue("Styled Text");
cell.setStyle(style);

await workbook.save("styled.xlsx");

导出为多种格式

使用不同的文件扩展名调用 workbook.save()，将相同的数据导出为 CSV、JSON、Markdown 或 HTML —— 无需单独的转换步骤：

import { Workbook } from "excel-cells";

const workbook = new Workbook();
const worksheet = workbook.worksheets[0]!;
worksheet.putValue("A1", "Name");
worksheet.putValue("B1", "Age");
worksheet.putValue("A2", "Alice");
worksheet.putValue("B2", 25);

await workbook.save("data.xlsx");
await workbook.save("data.csv");
await workbook.save("data.json");
await workbook.save("data.md");

另请参阅

 中文