跳转至
.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 项明细见格式能力矩阵。

已知边界

在选型前请先确认这几条:

  1. 读取入口 —— Excel.Read<T> 只支持 xlsx / xlsm;xls / xlsb / csv 用 Excel.Open 按扩展名路由。
  2. CSV —— 单工作表、纯文本、不带样式,所有值按文本读回。
  3. 密码与宏 —— xls 不支持密码;含宏工作簿只能存为 xlsm 或 xlsb。
  4. 图表与透视表 —— 只保留不编辑。xlsx / xlsm / xlsb 打开再保存原样保留,xls / csv 会丢。
  5. 流式与追加 —— 只支持 xlsx / xlsm。

目标格式不支持的能力不会静默丢弃

写到 xls / xlsb / csv 时,被丢弃的能力会通过 OnDegradation 回调逐项上报。 详见降级回调。

接下来

运行示例

仓库自带 33 个可运行示例,覆盖写读 / 样式 / 筛选 / 批注 / 加密 / 图片 / 条件格式等用法:

dotnet run --project demo/LiteExcel.Demo

输出写到程序运行目录的 Output 文件夹,控制台会打印完整路径。