最稳方案是用EPPlus读Excel再写HTML：避免Interop和XML解析，用Cells范围读取、cell.Text获取显示值，StreamWriter流式输出HTML，注意UTF-8编码、合并单元格转colspan/rowspan及字体/边框映射。

用 EPPlus 读 Excel 再写 HTML 最稳

直接上结论：别手写 XML 解析，也别碰 Microsoft.Office.Interop.Excel（它依赖 Office 安装、线程不安全、服务器上基本跑不通）。EPPlus 是目前 C# 里处理 Excel 文件最靠谱的开源库，支持 .xlsx，纯内存操作，无外部依赖。

常见错误是试图用 StreamReader 直接读 .xlsx 文件——那是 ZIP 包，不是文本；还有人用 OleDbConnection 连接 Excel，结果在 .NET Core/.NET 5+ 上根本没对应驱动，报 "Could not find installable ISAM"。

• 安装 NuGet 包：Install-Package EPPlus（注意 v6+ 需要 license，v5.8.7 仍免费且够用）
• 打开工作簿后，优先用 worksheet.Cells["A1:Z1000"] 范围读取，比逐行 Rows 遍历快得多
• HTML 表格结构建议用 ，避免内联样式爆炸；样式留到 CSS 处理
  单元格合并（Merge）必须转成 colspan/rowspan，否则 HTML 表格会错位——EPPlus 的 worksheet.Cells[row, col].Merge 属性得自己解析

  HtmlAgilityPack 不适合做 Excel → HTML 转换

  有人想先生成 HTML 字符串再用 HtmlAgilityPack 修补结构，这是绕远路。它定位是「解析/修改已有 HTML」，不是「生成带格式的表格」。你没法靠它自动还原 Excel 的边框颜色、字体大小、数字格式（比如 `#,##0.00`），反而容易把 &、 双重转义成 & 或 。

  典型翻车场景：Excel 里写了 =SUM(A1:A10)，你读出来是公式字符串，但直接塞进 HTML 就变成纯文本；而如果读 Value 属性，又可能丢掉原始格式（如货币符号、百分比）。

  • 读单元格内容优先用 cell.Text（保留显示效果），而非 cell.Value（原始值）
  • 日期类型需手动判断：cell.Value is DateTime 时，用 cell.Value.ToString("yyyy-MM-dd")，否则可能输出 OADate 数字
  • 超链接要单独提取：cell.Hyperlink?.Uri?.ToString()，Text 里不包含链接地址

  导出大文件时内存暴涨？用流式写入 + 分块

  一个 5MB 的 Excel（约 10 万行）转成 HTML 后可能撑到 200MB 内存——全因为字符串拼接和 DOM 构建全在内存里。不是代码写错了，是默认方式太“老实”。

  

  C#

  "避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

  下载

  关键不是换库，而是换思路：别攒完整 HTML 字符串，改用 StreamWriter 边读边写，配合 StringBuilder 缓冲单行或单页。

  • 打开工作表后，用 worksheet.Dimension 拿到实际范围（比如 A1:G50000），避免遍历空行
  • 每写 1000 行就调用一次 streamWriter.Flush()，防止缓冲区卡住
  • 图片不嵌入 base64（体积翻 3 倍），改用 ，提前把 worksheet.Drawings 中的图另存为文件
  • .NET 6+ 可用 Utf8JsonWriter 类似思路写 HTML，但需自己保证标签闭合——不如老实用 StreamWriter

  中文乱码、样式丢失？检查三处编码与 CSS

  生成的 HTML 打开是方块字，或者加粗/居中全失效，大概率不是 Excel 问题，是输出环节掉了链子。

  最常漏的是 HTTP 响应头或 HTML meta 标签没声明 UTF-8；其次是 Excel 单元格的 Style.Font.Name（如 "微软雅黑"）无法直接映射到网页字体，得 fallback 到 "Microsoft YaHei", sans-serif。

  • 写文件时必须指定编码：new StreamWriter(filePath, false, Encoding.UTF8)，别用默认构造函数
  • HTML 头部必须有：，否则浏览器可能按 GBK 解析
  • 边框样式不能只靠 border: 1px solid #000，Excel 的细线（xlHairline）得用 border: 0.5px solid #000 并开启 transform: scale(2) 模拟（CSS 支持 subpixel）
  • 合并单元格的 colspan 计算容易错：得用 worksheet.MergedCells 集合遍历，而不是靠相邻单元格是否为空来猜

  真正难的不是语法，是 Excel 格式语义到 HTML 的映射——比如“条件格式高亮”没有直接等价物，只能靠预扫描数据后加 class；“打印区域”在网页里压根没意义。这些细节不提前想清楚，上线后准返工。

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！