做Web报表预览时，最烦的一件事就是处理Excel。客户给你丢过来一个.xlsx，要求“在浏览器里能看、能放大、最好文字还能选中搜索”。转PDF确实是最常见的思路，但PDF在浏览器里的兼容性一言难尽，轻则插件版本对不上，重则样式错位。后来我把目标改成了SVG图片——一个SVG标签扔进前端，不用解析、不用插件，直接渲染。这篇文章记录的是我基于C#和Spire.XLS for .NET把Excel转成SVG图片的完整落地过程，重点包括方案选型、坐标换算、字体处理和两种可用的代码实现，适合正在做报表预览、文档在线展示或者数据可视化图层的.NET开发者参考。
1. 思路拆解：Excel转SVG要解决什么问题
1.1 典型应用场景
先说场景。我这次的需求来自一个生产看板项目，后台每天生成十几张Excel报表，前端要在一个大屏页面里展示，用户还会把浏览器缩放到150%去看细节。最初试过直接把Excel文件上传后由前端解析渲染，结果小文件还好，表格稍微大一点，前端解析库就很吃力。后面也试过转成PNG图片，处理少量报表还行，一旦涉及缩放，图片就糊得不能看。
类似的场景其实很常见：Web系统里的报表预览、企业内部OA中的Excel附件在线查看、数据可视化大屏中的表格叠加图层、甚至文档归档系统里要把Excel转成可检索的矢量文件。这些需求都有一个共性，就是“既要保留表格的外观，又不想引入复杂的前端依赖”。
SVG在这时候就是非常合适的中间格式。它是基于XML的矢量图，浏览器原生支持，不需要额外插件，缩放不损失清晰度，文字部分还能被搜索引擎检索、被用户选中复制。我把Excel转成SVG之后，前端只需要一个<img>标签或者直接内联一段SVG字符串就能展示，后端也不用维护一堆临时文件。
1.2 为什么输出SVG而不是PNG/JPG
很多同事问我，为什么不直接用Spire.XLS把Excel转成PNG，反正都是图片。这里面的差别在实际项目中非常大。
PNG虽然无损，但它是位图，尺寸固定。一张A4大小的报表按96 DPI导出，大概是800×1100像素，如果用户在大屏上放大到200%，边缘和文字就开始发虚。JPG更不用说，表格里的细边框在这种压缩格式下会出现明显的拉链噪声，完全不适合文档类内容。
SVG是矢量图，它描述的是“哪里画一个矩形、哪里写一行文字”，而不是逐像素记录颜色。所以在浏览器里，SVG无论放大多少倍，线条始终保持锐利，文字也始终清晰。另一个关键优势是体积，纯矢量SVG通常只有几KB到几十KB，而同等内容的PNG往往要几百KB甚至几MB。
还有一个容易被忽略的点：SVG里的文字是真实文本节点，不是像素。这意味着浏览器可以搜索、复制、翻译，甚至可以被屏幕阅读器朗读。对做信息无障碍或者文档检索的系统来说，这几乎是决定性优势。
1.3 为什么选择Spire.XLS
做Excel解析，.NET生态里常用NPOI、EPPlus、Spire.XLS这几个库。NPOI免费开源，能处理xls和xlsx，但API偏底，读写样式要自己拼很多代码；EPPlus功能强大，但新版本改了许可证策略，商用场景要小心；Spire.XLS是商业库，但提供了免费版，而且在样式读取上做得比较省事。
我这次选Spire.XLS，主要看中三点。
第一，它不需要服务器安装Office，也不依赖Excel COM组件，部署省心，不会出现“OFFICE没激活导致组件调用失败”这种坑。第二，它对样式体系的封装比较完整，单元格的字体、颜色、边框、对齐方式都能直接读取，不用自己去解析XML。第三，它自带将工作表渲染成图片的能力，可以充当快速兜底方案。
当然它也有缺点，免费版只能处理前103列和254行，对大多数中小型报表够用，但如果你的表格特别宽或者特别长，就得考虑升级付费或者换用其他库。我在项目里做了个前置检查，一旦工作表超出免费版限制，就自动走另一条兜底逻辑，这部分后面详细说。
2. 技术路线选型：两条可行方案对比
2.1 路线A：读取结构自绘SVG
这是我最推荐的一条路线，也是本文主角。思路很简单：先用Spire.XLS读取Excel的结构，包括每个单元格的值、字体、颜色、边框、合并区域，再根据行列宽高计算出坐标，按SVG语法把这几百个单元格重新画出来。
这样做出来的SVG是真正的矢量图，文字是可检索的文本节点，文件体积小，浏览器渲染性能高。后面的代码部分我会讲怎么实现。
这条路线也有适用范围限制。它处理纯数据表格、常规样式的报表非常理想，但如果Excel里嵌入了图表、图片、形状、数据透视表这类对象，自绘方案就需要额外处理，否则这些对象会丢失。我在项目中明确了适用范围，遇到纯数据报表走自绘SVG，遇到复杂报表就退回到路线B。
2.2 路线B：渲染成图再内嵌SVG
路线B更像一个“曲线救国”的方案。Spire.XLS可以把工作表渲染成一张位图，比如PNG。我先用Spire.XLS把Excel转成PNG，然后把PNG做base64编码，嵌到一个SVG文件里。
这里确实做了SVG，但SVG内部其实只有一张位图，放大之后仍然会糊。它的优势是“保真”，Excel里的图表、形状、图片、背景色通通都会被Spire.XLS的渲染引擎画到位图里，不丢元素。
这个方案适合什么情况？比如Excel文件里有复杂的条件格式、迷你图或者嵌入的图表，自绘SVG暂时画不出来，那就可以用位图兜底。又比如你只是想快速做一个“能在线看Excel”的功能，不想花精力处理样式细节，路线B几分钟就能搞定。
2.3 两种方案怎么选
我整理了一张简单的对比表，方便后面参考。
| 对比维度 | 路线A：自绘SVG | 路线B：位图内嵌SVG |
|---|---|---|
| 是否矢量 | 是，缩放清晰 | 否，内部是位图 |
| 文字可搜索 | 可以 | 不可以 |
| 文件体积 | 小，几KB到几十KB | 大，取决于位图尺寸 |
| 保留图表/图片 | 不保留，需自行扩展 | 完整保留 |
| 实现复杂度 | 中，需要处理坐标和样式 | 低，几行代码 |
| 推荐场景 | 纯数据报表、需要检索和缩放 | 复杂报表、快速实现 |
实际项目里我建议先判断Excel是否包含复杂对象。如果只是单元格和边框，就走路线A；如果检测到嵌入图表、图片或者形状，就自动降级到路线B。这样既有性能，又有兜底，用户完全感知不到后端的切换逻辑。
3. 环境准备：引入Spire.XLS与前置知识
3.1 NuGet安装与框架版本
这个方案的运行环境是.NET，我用的是.NET 6，项目类型是控制台程序，用来做批量转换测试。你如果是ASP.NET Core Web API，使用方式完全一样。
打开NuGet包管理器，搜索Spire.XLS，安装最新稳定版即可。命令行安装也可以：
dotnet add package Spire.XLSSpire.XLS从某个版本开始分成了免费版和付费版，NuGet上直接搜到的那个包包含了完整API，但免费使用时会受限。如果只想用免费的扩展能力，可以搜索Spire.XLS.Free，不过我还是建议用完整包，后面讲讲原因。
安装完成后，在代码文件顶部加上：
using Spire.XLS;这个命名空间包含了Workbook、Worksheet、CellRange这些核心类，绝大多数操作都从这里开始。
3.2 Spire.XLS免费版的限制
使用免费版的重点是清楚边界在哪里。
免费版转换时最多只能读取工作表的前103列和前254行，超过部分的单元格内容拿不到。另外，导出的图片或者文档中会带一个红色的评估水印。如果你只是内部用、不受水印困扰，免费版做原型验证是足够的。
我在项目里做了个保护措施。加载完Excel之后，先检查工作表的实际行列数，如果超出免费版范围，就限制转换的行列数，同时向日志输出一条警告，提示管理员考虑升级授权。这样可以避免用户看到一张不完整的报表时误以为是程序Bug。
注意，这个限制是针对“每个工作表”的，不是整个工作簿。如果你的报表有多个工作表，每个表各自在103×254以内，就都可以正常转换。
3.3 需要提前了解的API
Spire.XLS的核心对象模型其实和Excel本身的层次结构很像，从大往小是Workbook、Worksheet、CellRange。我这次用到的主要API有这些：
Workbook.LoadFromFile：加载Excel文件，支持xls和xlsx。Workbook.Worksheets[index]：按索引获取工作表。Worksheet.Rows和Worksheet.Columns：获取行和列的集合，访问行高和列宽。Worksheet.Range[row, col]：获取某个单元格，返回CellRange对象。CellRange.Value：获取单元格显示值。CellRange.Style：包含字体、颜色、对齐、边框等样式信息。Worksheet.MergedCells：返回合并单元格区域的集合。
如果单元格里是公式，直接读Value可能会拿到缓存的计算结果。万一数据没算出来，可以调用workbook.CalculateAllValue()强制重算，然后再读Value。
3.4 行列宽高单位换算
这是整篇文章最关键的细节之一。SVG用的是像素坐标，而Excel的行高和列宽有自己的一套单位。
先看行高。Excel的行高单位是point（磅)，1磅等于1/72英寸。在96 DPI的屏幕上，1磅等于96/72像素，也就是4/3像素。所以读取到的RowHeight是30的话，实际像素高度就是30×4/3=40像素。
再看列宽。Excel的列宽单位是“字符数”，也就是在这一列里能容纳多少个标准字体（通常是11号Calibri或宋体）的字符。这个单位转像素就没有那么精确了，业界普遍的做法是乘一个经验系数。我实测在默认字体情况下，1个字符宽度约等于7像素，所以列宽20就约等于140像素。
当然，如果列里的字体不是默认字体，这个系数会略有变化。更精确的做法是用System.Drawing去测量标准字符的实际像素宽度，但我在项目中实测下来，用7作为基准系数已经能满足绝大多数报表的视觉还原度，而且计算速度很快。后面代码里我也是用这个系数。
4. 实操一：读取Excel数据和样式
4.1 加载工作簿并定位工作表
第一步是加载Excel文件并确定要转换的工作表。我封装了一个方法，允许调用方指定工作表索引，默认取第一个。
public static Worksheet LoadWorksheet(string excelFilePath, int sheetIndex) { Workbook workbook = new Workbook(); workbook.LoadFromFile(excelFilePath); return workbook.Worksheets[sheetIndex]; }这里有个需要注意的地方：Workbook对象在离开方法之后如果没有被释放，可能会占用文件句柄。实际项目中建议用using语句或者在使用完毕后调用Dispose。如果你是一次性加载多个文件做批量转换，不释放句柄很容易造成文件被占用，Windows上还会报“文件正在被另一个进程使用”。
4.2 获取已使用区域和行列尺寸
加载完工作表，我需要知道这张表实际有多少行、多少列，避免把空行也输出到SVG里。
int usedRows = worksheet.Rows.Length; int usedCols = worksheet.Columns.Length;在Spire.XLS中，Rows.Length返回的是已使用行数，Columns.Length返回的是已使用列数，不是Excel最大行数1048576。我还是会在代码里加日志输出这两个值，方便核对。
有了行列数，就可以生成两个数组，分别保存每一列和每一行的像素尺寸。这部分是后面坐标计算的基础。
const double pxPerPoint = 96.0 / 72.0; const int defaultCharWidth = 7; int[] colWidths = new int[usedCols + 1]; int[] rowHeights = new int[usedRows + 1]; int totalWidth = 0; int totalHeight = 0; for (int c = 1; c <= usedCols; c++) { colWidths[c] = (int)Math.Ceiling(worksheet.Columns[c].ColumnWidth * defaultCharWidth); totalWidth += colWidths[c]; } for (int r = 1; r <= usedRows; r++) { rowHeights[r] = (int)Math.Ceiling(worksheet.Rows[r].RowHeight * pxPerPoint); totalHeight += rowHeights[r]; }这里我先把每列的宽度、每行的高度都算成像素，并累加出总画布尺寸。后面遍历单元格时，每移动一列，x坐标就增加该列的宽度；每移动一行，y坐标就增加该行的高度。这个思路理解之后，坐标映射就不会乱。
4.3 读取单元格内容与样式
读取单元格的值和样式是自绘SVG最重要的一步。我在循环里对每个单元格做了这样的处理：
CellRange cell = worksheet.Range[r, c]; string text = cell.Value?.ToString() ?? ""; if (!string.IsNullOrEmpty(text)) { // 读取字体 string fontName = cell.Style.Font.FontName; double fontSize = cell.Style.Font.Size; bool isBold = cell.Style.Font.IsBold; string fontColor = ColorToHtml(cell.Style.Font.Color); // 读取对齐 var hAlign = cell.Style.HorizontalAlignment; var vAlign = cell.Style.VerticalAlignment; }注意，cell.Value的类型是object，某些情况下会返回null，所以用?.ToString()做防空处理。如果单元格是日期类型，ToString可能输出一串数字，实际项目中可以根据单元格的格式化字符串再处理一层，让日期显示成业务要求的格式。
ColorToHtml是我写的一个小工具，用来把Color类型的颜色转成CSS用的十六进制字符串，后面写入SVG属性用。
private static string ColorToHtml(Color color) { return $"#{color.R:X2}{color.G:X2}{color.B:X2}"; }4.4 处理合并单元格
合并单元格是自绘SVG里最容易踩坑的地方。如果不处理，同一个合并区域里的每个单元格都会画出一个独立的矩形和文本，视觉上完全错乱。
我的解法是提前构建一个字典，把合并区域内的所有坐标映射到左上角那个单元格。遍历单元格时，如果当前坐标不是合并区域的左上角，就直接跳过，因为左上角那个单元格会绘制整个合并区域。
private static Dictionary<(int row, int col), CellRange> BuildMergedMap(Worksheet sheet) { var map = new Dictionary<(int, int), CellRange>(); foreach (CellRange range in sheet.MergedCells) { for (int r = range.Row; r < range.Row + range.RowCount; r++) { for (int c = range.Column; c < range.Column + range.ColumnCount; c++) { map[(r, c)] = range; } } } return map; }这个字典在后面的绘制循环里会被频繁查询。由于我预先构建了一次，实际遍历时判断是否合并的复杂度是O(1)，比每次循环都去遍历MergedCells集合要高很多。对大表格来说，这个优化非常明显。
5. 实操二：自绘SVG矢量图
5.1 SVG坐标与Excel坐标的映射
SVG的坐标系和Excel的表格结构很像，都是从左上角开始，x轴向右，y轴向下。所以做映射的思路很直观。
画的时候我从第一行第一列开始，维护两个游标变量x和y。每处理完一个单元格，x就增加当前列的宽度；每处理完一行，x归零，y增加当前行的高度。这样边走边累加，就能保证每个矩形和文字都落在正确的位置。
展开来说，就是这样一个双层循环：
int y = 0; for (int r = 1; r <= usedRows; r++) { int x = 0; for (int c = 1; c <= usedCols; c++) { // 当前单元格的左上角就是 (x, y) // 处理完毕后增加列宽 x += colWidths[c]; } y += rowHeights[r]; }这样做的优点是逻辑简单、不容易出错，而且天然适配隐藏行列——如果某行被隐藏，行高为0，累加后x或y不影响整体布局。
5.2 完整代码实现
下面给出一个相对完整、可以直接运行的自绘SVG版本。为了代码可读性，我把首轮矩形绘制和第二轮文本绘制分开做。这样做的原因是SVG默认后面的元素会覆盖前面的元素，如果矩形和文本交替输出，文本会被后画的矩形盖住。先输出所有矩形，再输出所有文本，层级就对了。
public static string ConvertExcelToSvg(string filePath, int sheetIndex = 0) { using Workbook workbook = new Workbook(); workbook.LoadFromFile(filePath); Worksheet sheet = workbook.Worksheets[sheetIndex]; int usedRows = sheet.Rows.Length; int usedCols = sheet.Columns.Length; const double pxPerPoint = 96.0 / 72.0; const int defaultCharWidth = 7; int[] colWidths = new int[usedCols + 1]; int[] rowHeights = new int[usedRows + 1]; int totalWidth = 0; int totalHeight = 0; for (int c = 1; c <= usedCols; c++) { colWidths[c] = (int)Math.Ceiling(sheet.Columns[c].ColumnWidth * defaultCharWidth); totalWidth += colWidths[c]; } for (int r = 1; r <= usedRows; r++) { rowHeights[r] = (int)Math.Ceiling(sheet.Rows[r].RowHeight * pxPerPoint); totalHeight += rowHeights[r]; } var mergedMap = BuildMergedMap(sheet); var sb = new StringBuilder(); sb.Append($"<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"{totalWidth}\" height=\"{totalHeight}\" viewBox=\"0 0 {totalWidth} {totalHeight}\">"); sb.Append($"<rect x=\"0\" y=\"0\" width=\"{totalWidth}\" height=\"{totalHeight}\" fill=\"#ffffff\"/>"); // 第一轮：绘制背景和边框 int currentY = 0; for (int r = 1; r <= usedRows; r++) { int currentX = 0; for (int c = 1; c <= usedCols; c++) { CellRange merged = null; if (mergedMap.TryGetValue((r, c), out merged)) { if (!(merged.Row == r && merged.Column == c)) { currentX += colWidths[c]; continue; } } int cellWidth = colWidths[c]; int cellHeight = rowHeights[r]; if (merged != null) { cellWidth = 0; cellHeight = 0; for (int cc = merged.Column; cc < merged.Column + merged.ColumnCount; cc++) cellWidth += colWidths[cc]; for (int rr = merged.Row; rr < merged.Row + merged.RowCount; rr++) cellHeight += rowHeights[rr]; } CellRange cell = sheet.Range[r, c]; string fillColor = ColorToHtml(cell.Style.Color); string borderColor = ColorToHtml(cell.Style.Borders[BordersLineType.EdgeLeft].Color); int borderWidth = 1; sb.Append($"<rect x=\"{currentX}\" y=\"{currentY}\" width=\"{cellWidth}\" height=\"{cellHeight}\" fill=\"{fillColor}\" stroke=\"{borderColor}\" stroke-width=\"{borderWidth}\" shape-rendering=\"crispEdges\"/>"); currentX += colWidths[c]; } currentY += rowHeights[r]; } // 第二轮：绘制文本 currentY = 0; for (int r = 1; r <= usedRows; r++) { int currentX = 0; for (int c = 1; c <= usedCols; c++) { CellRange merged = null; if (mergedMap.TryGetValue((r, c), out merged)) { if (!(merged.Row == r && merged.Column == c)) { currentX += colWidths[c]; continue; } } int cellWidth = colWidths[c]; int cellHeight = rowHeights[r]; if (merged != null) { cellWidth = 0; cellHeight = 0; for (int cc = merged.Column; cc < merged.Column + merged.ColumnCount; cc++) cellWidth += colWidths[cc]; for (int rr = merged.Row; rr < merged.Row + merged.RowCount; rr++) cellHeight += rowHeights[rr]; } CellRange cell = sheet.Range[r, c]; string text = cell.Value?.ToString()?.Trim() ?? ""; if (!string.IsNullOrEmpty(text)) { sb.Append(BuildTextElement(text, cell, currentX, currentY, cellWidth, cellHeight)); } currentX += colWidths[c]; } currentY += rowHeights[r]; } sb.Append("</svg>"); return sb.ToString(); }这段代码的核心逻辑并不复杂，但已经能应付大多数纯数据表格。两个循环里对合并单元格的宽度高度计算逻辑是重复的，实际项目可以抽成一个方法，我这里为了便于阅读就保留了重复。
5.3 关键细节：文字对齐、换行、颜色
BuildTextElement方法负责把单元格文字转成SVG的text标签。这里要注意的地方很多。
SVG的text元素支持text-anchor属性控制水平对齐：start对应左对齐，middle对应居中对齐，end对应右对齐。垂直对齐则可以用dominant-baseline来设置，比如auto对应默认基线，central表示垂直居中，hanging表示靠上。
我结合Excel单元格里的水平和垂直对齐方式，把这些映射关系封装在方法里：
private static string BuildTextElement(string text, CellRange cell, int x, int y, int width, int height) { string fontName = cell.Style.Font.FontName ?? "Arial"; double fontSize = cell.Style.Font.Size > 0 ? cell.Style.Font.Size : 10; string fontColor = ColorToHtml(cell.Style.Font.Color); bool isBold = cell.Style.Font.IsBold; string anchor = "start"; double textX = x + 4; if (cell.Style.HorizontalAlignment == HorizontalAlignType.Center) { anchor = "middle"; textX = x + width / 2.0; } else if (cell.Style.HorizontalAlignment == HorizontalAlignType.Right) { anchor = "end"; textX = x + width - 4; } string baseline = "central"; double textY = y + height / 2.0 + fontSize * 0.15; if (cell.Style.VerticalAlignment == VerticalAlignType.Top) { baseline = "hanging"; textY = y + fontSize + 2; } else if (cell.Style.VerticalAlignment == VerticalAlignType.Bottom) { baseline = "auto"; textY = y + height - 4; } string fontWeight = isBold ? "bold" : "normal"; // 处理单元格内换行 string[] lines = text.Split('\n'); var sb = new StringBuilder(); for (int i = 0; i < lines.Length; i++) { if (i == 0) { sb.Append(EscapeXml(lines[i])); } else { sb.Append($"<tspan x=\"{textX:0.##}\" dy=\"1.2em\">{EscapeXml(lines[i])}</tspan>"); } } return $"<text x=\"{textX:0.##}\" y=\"{textY:0.##}\" font-family=\"{fontName}\" font-size=\"{fontSize}\" fill=\"{fontColor}\" text-anchor=\"{anchor}\" dominant-baseline=\"{baseline}\" font-weight=\"{fontWeight}\">{sb}</text>"; }有几处细节是测试了好几轮才发现的。
第一，垂直居中不能直接把textY设为y + height / 2，因为SVG的central基线是以文字中心为参考，实际观感会偏下一点，我加了fontSize * 0.15这个微调值，肉眼看上去才真正居中。
第二，换行用<tspan>实现时，每个后续行要重新设置x坐标，否则会继承上一行的x起点，换行位置就乱了。我每个tspan都写上了x属性，确保从同一位置换行。
第三，文本里的<、>、&这些符号必须做XML转义，否则SVG解析会出错。我用System.Security.SecurityElement.Escape做了处理，遇到数据里包含“<10元”这种内容时就不会把SVG撑坏。
6. 实操三：SheetToImage快速转SVG
6.1 用工作表直接生成位图
自绘SVG处理不了的复杂报表，我会改用Spire.XLS自带的渲染能力，直接生成一张位图。
using System.Drawing; using System.Drawing.Imaging; using Spire.XLS; using Workbook workbook = new Workbook(); workbook.LoadFromFile("complex.xlsx"); Worksheet sheet = workbook.Worksheets[0]; using Image image = sheet.ToImage();Worksheet.ToImage()是Spire.XLS提供的方法，它会按照工作表的样式把内容渲染成一张图片。你可以指定像素范围，也可以直接用默认值。调用一次之后，图表、图片、形状都会被画进去，这是自绘SVG目前做不到的。
如果对输出分辨率有要求，可以设置一个scale系数，生成一张大尺寸位图。比如希望容器里的SVG能够支持一定的缩放，就把图片按两倍尺寸导出，视觉上会好很多。
6.2 位图转base64并写入SVG
生成位图之后，我把它保存到内存流，转成base64字符串，然后嵌入SVG的image标签。
public static string ConvertExcelToSvgWithBitmap(string filePath, int sheetIndex = 0) { using Workbook workbook = new Workbook(); workbook.LoadFromFile(filePath); Worksheet sheet = workbook.Worksheets[sheetIndex]; using Image image = sheet.ToImage(); using var ms = new MemoryStream(); image.Save(ms, ImageFormat.Png); byte[] bytes = ms.ToArray(); string base64 = Convert.ToBase64String(bytes); int width = image.Width; int height = image.Height; return $"<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"{width}\" height=\"{height}\" viewBox=\"0 0 {width} {height}\">" + $"<image href=\"data:image/png;base64,{base64}\" x=\"0\" y=\"0\" width=\"{width}\" height=\"{height}\"/>" + $"</svg>"; }这里生成的SVG文件虽然后缀是svg，但内容主体是一张base64图片。它最大的好处是“保持原样”，不管Excel里有什么元素，渲染成什么样，SVG里就是什么样。代价是文件体积明显变大，而且文字不可检索。
生成之后我们可以根据文件大小决定走哪种方式，我写了一个简单的判断逻辑：先尝试用自绘SVG，检测到工作簿里有非单元格对象就转用位图方案。这样能在“保真”和“体积/可检索”之间取得平衡。
6.3 两种方案的输出效果对比
我在一个包含10行、6列、带合并单元格和浅色填充的测试报表上做了对比。
自绘SVG输出了一个约3KB的文件，文字清晰、可复制，浏览器放大300%依然锐利。位图内嵌方案导出了一个约180KB的PNG，视觉上更接近原生Excel，但文件大得多，而且放大到200%时文字边缘已经开始糊。
如果你的项目只是内部管理后台，用户不会频繁缩放，位图方案其实够用。但如果是面向用户的大屏展示，我还是建议上自绘SVG，效果差得不是一点点。
7. 常见问题与排查技巧实录
7.1 中文字体乱码和缺失
自绘SVG最常遇到的问题就是中文乱码。很多Excel文件里的中文字体是“微软雅黑”或者“宋体”，但服务器如果是Linux环境，这些字体没安装，SVG渲染时就只能回退到默认字体，看起来像是排版错乱甚至“缺字”。
解决方案有两种。一种是在服务器上安装中文字体包，Windows上装微软雅黑，Linux上装fonts-wqy-zenhei或者fonts-noto-cjk。另一种是在生成SVG时指定通用字体栈，比如font-family="'Microsoft YaHei','PingFang SC','Noto Sans CJK SC',sans-serif"。这样即使服务器没有特定字体，SVG在用户浏览器里也能用用户本地的中文字体兜底。
我在实际代码里是把字体名从Excel读出来之后，再拼接一套通用中文字体栈，不要只输出原始字体名，这个技巧在跨平台部署时很管用。
7.2 合并单元格位置错乱
合并单元格导致的位置错乱多半是坐标累加的问题。如果你在处理合并区域时，非左上角的单元格也执行了“画矩形”操作，就会在中间位置多出一些边框碎片，看起来像表格被切开了。
排查技巧是先把合并区域的坐标打印出来，对照Excel看一遍。我习惯在调试阶段把每个被跳过的单元格也输出日志，确认“跳过”逻辑没有误伤正常单元格。另外注意，Spire.XLS的Row和Column属性是从1开始的，如果你之前用0基数组的习惯，很容易在这个地方错位。
7.3 大文件转换性能优化
如果你的Excel报表很长，比如几千行，自绘SVG的性能会直接暴露问题。最容易拖慢速度的点是循环里频繁调用sheet.Range[r, c]取单元格，Spire.XLS每次调用都有开销。
我做过一次简单优化，把循环里重复调用的worksheet.Rows[r]、worksheet.Columns[c]提取到循环外，性能提升明显。另一个做法是分批次处理，比如每500行生成一个SVG片段，最后再拼接，避免一次性构建超长字符串导致的内存压力。
如果报表实在太长，输出文件也会变大。我在项目中设置了一个阈值，超过2000行的报表自动切分成多个SVG块，前端按需加载，滚动体验反而比一次渲染整张大图更好。
7.4 跨平台运行报GDI+错误
Spire.XLS的渲染能力依赖GDI+，在Linux或者Docker容器里运行时，可能会遇到“GDI+发生一般性错误”这类异常。这是因为容器环境缺少libgdiplus。
解决方法是安装libgdiplus，基于Debian的镜像可以执行apt-get install -y libgdiplus。自绘SVG这条路对GDI+的依赖相对小一点，但读取样式时如果用到了System.Drawing.Common相关API，同样需要留意。为了避免这种问题，我在自绘方案里尽量不直接依赖System.Drawing的常用转换逻辑，颜色转换完全自己写，这样跨平台更省心。
7.5 常见问题速查表
| 现象 | 大概率原因 | 处理办法 |
|---|---|---|
| 输出的SVG打开是空白 | 数据量超出免费版行列限制 | 检查行列数，超过则截断或升级授权 |
| 中文变成方块或乱码 | 服务器缺少中文字体 | 安装中文字体包，或指定通用字体栈 |
| 合并单元格有碎片 | 非左上角单元格也执行了绘制 | 用合并区域字典跳过非左上角单元格 |
| 文本超出单元格边框 | 未设置text-anchor和baseline | 按对齐方式设置锚点和基线 |
| SVG体积突然巨大 | 走了位图内嵌方案 | 若是纯表格，应改走自绘SVG |
| Linux容器运行报GDI+错误 | 缺少libgdiplus | 安装libgdiplus依赖 |
| 数值显示成科学计数法 | 直接读Value未处理格式 | 根据NumberFormat格式化后再输出 |
最后再分享一个小技巧。自绘SVG方案调试时，把生成的SVG字符串直接保存成.svg文件，用浏览器打开，比在代码里断点看字符串高效得多。我通常还会在SVG的根节点上加一个xmlns命名空间，这样即使某些平台把SVG当XML解析，也能正常识别。这个转换方法在项目里跑了快半年，最深的体会是：Excel转SVG这件事，真正值钱的部分不在“转”，在于你怎么处理行列坐标、合并单元格和字体这些细节，把这些细节磨清楚了，后面加什么功能都顺手。
