C# NPOI是否支持中日注音文本？处理.xlsx注音文件遇异常求助

问题分析 #

• 使用NPOI操作带有日文注音指南的.xlsx文件时，输出文件会弹出「存在不可读内容」警告，同时出现部分数据丢失的情况；但处理.xls文件时无此异常。
• 核心原因是NPOI的XSSF组件（负责处理.xlsx格式）未支持微软Excel的日文注音指南特性，手动逐个关闭单元格的注音指南可恢复正常，但操作效率极低。

可行解决方案 #

方案1：批量移除.xlsx中的注音指南（自动预处理） #

利用OpenXML SDK直接操作xlsx的底层XML结构，批量清除所有单元格的注音相关标签，再交给NPOI处理。示例代码如下：

using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Spreadsheet;
using System.IO;
using System.Linq;

public void RemoveRubyAnnotations(string inputPath, string tempPath)
{
    // 复制原文件到临时路径，避免修改原文件
    File.Copy(inputPath, tempPath, overwrite: true);
    
    using (SpreadsheetDocument doc = SpreadsheetDocument.Open(tempPath, true))
    {
        WorkbookPart workbookPart = doc.WorkbookPart;
        foreach (WorksheetPart worksheetPart in workbookPart.WorksheetParts)
        {
            Worksheet worksheet = worksheetPart.Worksheet;
            var cells = worksheet.Descendants<Cell>();
            
            foreach (Cell cell in cells)
            {
                if (!string.IsNullOrEmpty(cell.InnerXml) && cell.InnerXml.Contains("<ruby>"))
                {
                    // 移除所有注音相关的XML标签，保留纯文本内容
                    cell.InnerXml = cell.InnerXml
                        .Replace("<ruby>", "")
                        .Replace("</ruby>", "")
                        .Replace("<rt>", "")
                        .Replace("</rt>", "")
                        .Replace("<rPh>", "")
                        .Replace("</rPh>", "");
                }
            }
            worksheet.Save();
        }
        doc.Save();
    }
}

使用时先调用预处理方法生成无注音的临时文件，再用NPOI读取临时文件执行后续逻辑：

string tempFile = @"C:\temp\processed_file.xlsx";
RemoveRubyAnnotations(@"原文件路径.xlsx", tempFile);

// 后续将tempFile作为NPOI的输入文件，执行你的writeoutput逻辑

方案2：替换为EPPlus库处理 #

EPPlus对Excel的日文注音指南特性支持更完善，可直接处理带注音的.xlsx文件而不出现异常。示例代码片段：

using OfficeOpenXml;
using System.IO;

public void WriteOutputWithEPPlus(string val)
{
    try
    {
        ExcelPackage.LicenseContext = LicenseContext.NonCommercial; // 根据使用场景调整许可
        string inputPath = @"原文件路径.xlsx";
        string outputPath = @"输出文件路径.xlsx";
        
        using (ExcelPackage package = new ExcelPackage(new FileInfo(inputPath)))
        {
            ExcelWorksheet sheet = package.Workbook.Worksheets[0];
            sheet.CopyTo("NewSheet");
            
            // Excel行列号从1开始，对应原代码的行35列8
            ExcelRange targetCell = sheet.Cells[36, 9];
            targetCell.Value = val;
            
            package.SaveAs(new FileInfo(outputPath));
        }
    }
    catch (Exception e)
    {
        Console.WriteLine(e);
    }
    finally
    {
        textBox2.Text = "done";
    }
}

方案3：NPOI备选配置（效果有限） #

如果必须使用NPOI，可尝试启用忽略未识别特性的配置，但该方法无法保证完全解决数据丢失问题，仅作为应急备选：

using (FileStream file = new FileStream(outPath, FileMode.Open, FileAccess.Read))
{
    XSSFWorkbook workbook = new XSSFWorkbook(file);
    // 设置忽略未识别的XML元素，减少解析报错
    workbook.SetMissingCellPolicy(MissingCellPolicy.CREATE_NULL_AS_BLANK);
    // 后续操作逻辑...
}

注意事项 #

• 方案1需要安装DocumentFormat.OpenXml NuGet包；
• 方案2的EPPlus需注意版本和许可协议，商业使用需购买官方授权；
• 操作前务必备份原文件，避免数据丢失。

内容的提问来源于stack exchange，提问作者fjyuser