syncfusion-flutter-excel

使用 Syncfusion Flutter XlsIO 库处理 Excel 文档

概述

使用 Syncfusion Flutter XlsIO 库创建、编辑和保存 Excel 工作簿（.xlsx）。 此技能支持为面向移动端、Web 和桌面平台的 Flutter 项目生成 Dart 代码片段。

主要功能

• 创建与编辑： 工作簿、工作表、单元格、行、列、单元格格式、样式、公式、命名范围、图表、图像、超链接、数据验证、条件格式
• 数据管理： 导入数据（列表、类型化数据、超链接、图像）、导出数据、高级筛选（文本、自定义、日期、动态、颜色筛选）、冻结窗格、显示/隐藏行列
• 高级功能： 支持国际化的 RTL 布局、CSV 导出、基于模板的操作、数据验证规则（文本、列表、数字、日期、小数、自定义）
• 图表与可视化： 创建和配置所有图表类型（饼图、条形图、柱形图、折线图、堆积图、3D 图表、专用图表），自定义元素（标题、图例、标签、位置）
• 安全性： 密码保护、工作表/工作簿加密、支持解锁选项的单元格保护
• 页面设置： 页边距、分页符、打印区域、页面方向、页眉/页脚

前提条件

• 已安装 Flutter SDK
• 在 pubspec.yaml 中添加依赖项：

  dependencies:
    syncfusion_flutter_xlsio: ^33.1.44
    syncfusion_officechart: ^33.1.44
  

• 使用 pub.dev 或 Syncfusion 文档中最新的兼容软件包版本。
• 运行：flutter pub get
• 在 Dart 代码中导入：

  import 'package:syncfusion_flutter_xlsio/xlsio.dart';
  import 'package:syncfusion_officechart/officechart.dart';
  

快速入门示例

生成 Dart 代码

用户：“请展示如何创建包含多个工作表的 Excel 工作簿” **结果：**显示 Dart 代码片段（不会创建文件）

---

模式：为用户的 Flutter 项目生成 Dart 代码

触发关键词：“展示如何”“如何”“我该如何”“怎么做”“提供代码”“提供示例”“举个例子”“演示”“代码片段”“示例代码”“示例”“样例”“给我”“展示给我”“main.dart”“示例代码”“为……生成代码”“代码片段”。

工作流：

步骤 1 — 检测平台并推荐正确的软件包

• 检查工作区项目文件（pubspec.yaml、main.dart 等），以确定 Flutter 目标平台（移动端、Web、桌面端）。
• 生成任何代码之前，先告知用户将 syncfusion_flutter_xlsio 添加到其 pubspec.yaml 中。

步骤 2 — 仅根据参考文件生成代码

切勿臆造、猜测或建议参考文件中未明确提及的任何 API、类、方法或属性。

• 阅读与所请求功能相关的 references/*.md 文件
• 严格依据这些文件中的 API 和代码片段编写 Dart 代码
• 针对目标平台使用正确的保存/启动模式：
  • 移动端 → getApplicationSupportDirectory() + OpenFile.open()
  • 桌面端 → getApplicationSupportDirectory() + OpenFile.open()
  • Web → base64 + JavaScript 下载或 web 软件包方案
• 不要创建或运行任何独立的 Dart 脚本

---

代码参考

所有代码片段都位于 references/ 文件夹中：

文件	内容
references/workbook.md	创建、保存／释放、异步操作、从右向左布局、导出 CSV
references/worksheet.md	创建、访问、选项卡颜色、调整大小、冻结窗格、页面设置
references/cell-data.md	向单元格添加文本、数字、日期和其他数据类型；创建超链接
references/hyperlinks.md	添加 URL 和 mailto 超链接
references/named-ranges.md	在公式中创建和使用命名范围
references/data-filtering.md	文本、自定义、日期、动态和颜色筛选器
references/cell-formatting.md	创建样式、全局应用、合并／取消合并单元格、内置样式
references/number-formats.md	数字、货币、百分比、日期、时间、会计、科学计数、分数、文本格式
references/rows-columns-manipulation.md	插入、删除、自动调整、显示／隐藏行和列；设置宽度／高度；数字格式
references/formulas.md	启用计算、应用公式、访问值、嵌套函数，以及 25+ 个函数（常规、逻辑、文本、时间、查找、统计、数学）
references/charts-basics.md	创建图表、自定义元素（标题、图例、标签、位置）
references/charts-types.md	所有图表类型（饼图、条形图、柱形图、折线图、堆积图、标记、3D、专用图表）
references/images.md	在工作表中插入、调整大小、翻转和旋转图像（JPEG、PNG）
references/security.md	使用密码保护工作簿和工作表，解锁单元格以供编辑
references/conditional-formatting-basics.md	单元格值、文本、日期、唯一值／重复值、最高／最低、 高于／低于平均值格式
references/conditional-formatting-advanced.md	色阶、图标集、数据条、自定义图标和可视化分析
references/data-import.md	将列表、类型化数据、超链接和图像导入工作表
references/data-validation.md	文本、时间、列表、数字、小数、日期和自定义公式验证规则
references/tables.md	使用内置主题创建、设置样式和管理 Excel 表格
references/culture.md	日期、时间、数字和货币格式的区域性／区域设置
references/page-setup.md	页面设置和打印设置（方向、页边距、分页符、打印区域）

---

规则

• 不要创建或运行临时脚本 — 此技能仅为用户项目生成代码（模式 1）
• 严格依据参考文件生成代码 — 切勿虚构 API 或方法
• 始终包含正确的导入：import 'package:syncfusion_flutter_xlsio/xlsio.dart'; 和 import 'package:syncfusion_officechart/officechart.dart';
• 对于移动端／桌面应用：使用 getApplicationSupportDirectory() + OpenFile.open() 保存文件
• 对于 Web 应用：使用 base64 + JavaScript 下载，或采用 web 包方案
• 保存后始终调用 workbook.dispose() 以释放内存
• 使用 saveSync() 同步保存工作簿，或使用 save() 异步保存
• 提醒用户在使用生成的代码前，先将 syncfusion_flutter_xlsio 和 syncfusion_officechart 添加到 pubspec.yaml