.NET · 零依赖 · 支持 AOT
不用装 Excel
也能读写 Excel¶
一个只用 .NET 基础类库实现的电子表格读写库。支持 xlsx / xlsm / xlsb / xls / csv,兼容 Native AOT,大文件可流式处理。
5支持格式
0第三方依赖
26能力项
33可运行示例
661单元测试
30 秒速览¶
支持格式xlsx · xlsm · xlsb · xls · csv
第三方依赖无,只用 .NET 基础类库
目标框架net48 · net8.0
Native AOT支持,公开 API 兼容裁剪
需要装 Excel 吗不需要
许可证MIT
安装¶
dotnet add package LiteExcel快速上手¶
using LiteExcel;
var wb = Excel.Create();
var ws = wb.Worksheets["Sheet1"];
ws.SetValue("A1", "姓名");
ws.SetValue("B1", "年龄");
ws.SetValue("A2", "张三");
ws.SetValue("B2", 25);
ws.Range("A1:B1").Style = new CellStyle { Bold = true };
wb.SaveAs("output.xlsx");
读回来:
var opened = Excel.Open("output.xlsx");
var name = opened.Worksheets[0].Cell("A2").GetString(); // → 张三
var age = opened.Worksheets[0].Cells[2, 2].GetDouble(); // → 25
能力矩阵¶
支持 · — 不支持 · 单元格内文字表示部分支持
| 能力 | xlsx | xlsm | xlsb | xls | csv |
|---|---|---|---|---|---|
| 数据读写 | 支持 | 支持 | 支持 | 支持 | 纯文本 |
| 样式与数字格式 | 支持 | 支持 | 仅数字格式 | 仅数字格式 | — |
| 表格布局(合并 / 行高 / 列宽) | 支持 | 支持 | 支持 | 支持 | — |
| 自动筛选 | 支持 | 支持 | — | — | — |
| 批注 | 支持 | 支持 | — | — | — |
| 数据验证 | 支持 | 支持 | — | — | — |
| 超链接 | 支持 | 支持 | 支持 | 支持 | — |
| 冻结窗格 | 支持 | 支持 | 支持 | 支持 | — |
| 图片 | 支持 | 支持 | — | — | — |
| 条件格式 | 支持 | 支持 | — | — | — |
| 超级表 | 支持 | 支持 | — | — | — |
| 公式 | 支持 | 支持 | 仅读取 | 仅读取 | — |
| 文件密码 | 支持 | 支持 | 支持 | — | — |
| 图表 / 透视表 | 原样保留 | 原样保留 | 原样保留 | — | — |
| 大文件流式读写 | 支持 | 支持 | — | — | — |
完整 26 项明细见格式能力矩阵。
已知边界¶
在选型前请先确认这几条:
- 读取入口 ——
Excel.Read<T>只支持 xlsx / xlsm;xls / xlsb / csv 用Excel.Open按扩展名路由。 - CSV —— 单工作表、纯文本、不带样式,所有值按文本读回。
- 密码与宏 —— xls 不支持密码;含宏工作簿只能存为 xlsm 或 xlsb。
- 图表与透视表 —— 只保留不编辑。xlsx / xlsm / xlsb 打开再保存原样保留,xls / csv 会丢。
- 流式与追加 —— 只支持 xlsx / xlsm。
目标格式不支持的能力不会静默丢弃
写到 xls / xlsb / csv 时,被丢弃的能力会通过 OnDegradation 回调逐项上报。
详见降级回调。
接下来¶
快速上手
15 分钟走完「新建 → 写值 → 保存 → 读回」的完整闭环。
我该用哪套 API
对象模型 / 低层 / 流式三种入口,一张表选清楚。
使用指南
按任务组织的 18 篇指南:样式、筛选、图片、下拉框、条件格式……
排障手册
Excel 报「文件损坏」、中文乱码、样式丢失、内存爆了怎么办。
运行示例¶
仓库自带 33 个可运行示例,覆盖写读 / 样式 / 筛选 / 批注 / 加密 / 图片 / 条件格式等用法:
输出写到程序运行目录的 Output 文件夹,控制台会打印完整路径。