C#实现高效读取Word表格数据并导出为CSV/TXT

2026-03-29 09:03:33 作者：Eiceblue

在.NET开发场景中,读取 Word 文档中的表格数据是办公自动化、数据导入、报表生成等业务的高频需求,本文将详细介绍如何用 C# 结合 Free Spire.Doc for .NET 库实现 Word 表格读取,有需要的小伙伴可以了解下

前言

在.NET开发场景中，读取 Word 文档中的表格数据是办公自动化、数据导入、报表生成等业务的高频需求。相比于原生操作Office COM组件（兼容性差、依赖环境），Free Spire.Doc for .NET 是一款轻量、免费、无依赖的 Word 操作组件，完美支持 C# 读取、解析 Word（.doc/.docx）格式的表格数据。

本文将详细介绍如何用 C# 结合 Free Spire.Doc for .NET 库实现 Word 表格读取，包含完整代码、核心API解析等。

开发环境准备

1. 基础环境要求

Visual Studio 2019+
.NET框架：.NET Framework 4.0+ / .NET 6/8（本文示例基于 .NET 6）
支持 Word 格式：.doc / .docx

2. NuGet 安装组件（极简操作）

右键项目 → 管理 NuGet 程序包；
搜索 FreeSpire.Doc；
点击安装，自动引用程序集。

命令行安装：Install-Package FreeSpire.Doc

免费版限制：单文档最大500段落、25个表格，满足绝大多数个人/小型项目需求。

核心 API 知识点（必看）

Free Spire.Doc 操作 Word 表格的核心对象，层级关系清晰：

类名	作用
Document	加载/操作整个 Word 文档
Section	Word 文档的节（容器）
Table	Word 表格对象
TableRow	表格的行
TableCell	表格的单元格
Paragraph.Text	获取单元格内的纯文本

读取逻辑：加载文档 → 遍历文档节 → 遍历节内表格 → 遍历行 → 遍历单元格 → 提取文本。

C# 读取 Word 表格完整代码

以下代码演示如何读取 Word 文档中所有表格的数据，并输出到控制台。示例 Word 文档包含两个表格，如下图：

场景1：读取 Word 中所有表格数据

using Spire.Doc;
using System;
namespace ReadWordTable
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. 初始化文档对象，加载Word文件
            Document doc = new Document();
            doc.LoadFromFile(@"E:\表格.docx"); // 替换为你的Word路径
            // 2. 遍历Word文档中的所有节
            foreach (Section section in doc.Sections)
            {
                // 3. 遍历当前节中的所有表格
                foreach (Table table in section.Tables)
                {
                    Console.WriteLine("===================== 读取表格数据 =====================");
                    // 4. 遍历表格的每一行
                    foreach (TableRow row in table.Rows)
                    {
                        // 5. 遍历当前行的每一个单元格
                        foreach (TableCell cell in row.Cells)
                        {
                            // 6. 获取单元格文本（去除空字符）
                            string cellText = cell.Paragraphs[0].Text.Trim();
                            Console.Write(cellText + "\t"); // 制表符分隔数据
                        }
                        Console.WriteLine(); // 换行
                    }
                }
            }
            // 释放资源
            doc.Close();
            Console.ReadLine();
        }
    }
}

运行代码后，控制台会按表格行列格式输出所有数据：

场景2：仅读取指定表格数据（精准读取）

也可以直接通过索引获取指定表格，读取其中数据，效率更高：

// 获取【第一个表格】（索引从0开始）
Table targetTable = doc.Sections[0].Tables[0] as Table;

进阶：将 Word 表格数据写入 TXT / CSV 文件

在实际开发中，读取 Word 表格后需要将数据持久化保存，最常用的是导出为 TXT 纯文本 和 CSV 文件。

必备命名空间：操作文件需要引入 System.IO，在代码顶部添加：

using System.IO;

示例 1：导出 Word 表格为纯 TXT 文本

特点：纯文本格式，用制表符分隔数据，可读性强，适合简单存储。

using System;
using System.IO;
using Spire.Doc;

namespace ReadWordToTxt
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. 加载Word文档
            Document doc = new Document();
            doc.LoadFromFile(@"E:\表格.docx");

            // 2. 设置TXT保存路径
            string txtPath = @"Word表格数据.txt";

            // 3. 创建文件流，写入数据
            using (StreamWriter sw = new StreamWriter(txtPath, false, System.Text.Encoding.UTF8))
            {
                // 遍历所有节、表格、行、单元格
                foreach (Section section in doc.Sections)
                {
                    foreach (Table table in section.Tables)
                    {
                        sw.WriteLine("===================== 表格数据 =====================");
                        foreach (TableRow row in table.Rows)
                        {
                            string rowData = "";
                            foreach (TableCell cell in row.Cells)
                            {
                                // 拼接单元格文本，制表符分隔
                                rowData += cell.Paragraphs[0].Text.Trim() + "\t";
                            }
                            // 写入一行数据
                            sw.WriteLine(rowData);
                        }
                    }
                }
            }

            // 4. 释放资源
            doc.Close();
            Console.WriteLine($"数据已成功写入：{txtPath}");
            Console.ReadLine();
        }
    }
}

生成的Word表格数据.txt文件：

示例 2：导出 Word 表格为 CSV 文件（推荐）

亮点汇总：

自动转义单元格逗号，避免格式错乱
UTF-8 编码，彻底解决 Excel 中文乱码
直接双击可用 WPS/Excel 打开做数据分析

using System;
using System.IO;
using Spire.Doc;

namespace ReadWordToCsv
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. 加载Word文档
            Document doc = new Document();
            doc.LoadFromFile(@"E:\表格.docx");

            // 2. 设置CSV保存路径
            string csvPath = @"Word表格数据.csv";

            // 3. 写入CSV文件（UTF-8编码，解决中文乱码）
            using (StreamWriter sw = new StreamWriter(csvPath, false, System.Text.Encoding.UTF8))
            {
                foreach (Section section in doc.Sections)
                {
                    foreach (Table table in section.Tables)
                    {
                        foreach (TableRow row in table.Rows)
                        {
                            string rowData = "";
                            foreach (TableCell cell in row.Cells)
                            {
                                string cellText = cell.Paragraphs[0].Text.Trim();
                                // CSV格式优化：文本加双引号，避免单元格内逗号导致格式错乱
                                rowData += $"\"{cellText}\",";
                            }
                            // 去除行尾多余逗号，写入文件
                            sw.WriteLine(rowData.TrimEnd(','));
                        }
                        // 表格之间空行分隔
                        sw.WriteLine();
                    }
                }
            }

            // 4. 释放资源
            doc.Close();
            Console.WriteLine($"数据已成功写入：{csvPath}");
            Console.ReadLine();
        }
    }
}

生成的Word表格数据.csv文件，用 Excel 打开可直接显示规整表格：

至此，我们完成了一套完整的 Word 表格数据读取方案。从文档加载、表格遍历到数据导出，整个过程并不复杂，关键点包含：

对象模型清晰：Document、Section、Table、TableRow、TableCell 层级分明，按序遍历即可拿到所需内容；
代码简洁直接：无论是控制台输出还是导出 TXT / CSV 文件，核心代码都在 20 行以内，易于理解和维护；
导出格式灵活：TXT 适合快速查看，CSV 则更适合数据交换与后续分析，两者都能满足日常开发需求。

这种方式最大的优势在于轻量、无环境依赖，不需要在服务器或客户端安装 Office 软件，也不涉及 COM 组件的繁琐配置，部署和维护都简单很多。对于大多数需要处理 Word 表格的业务场景——比如数据导入、报表自动化、内容提取等——这套方案足以覆盖常见需求。

如果你在实际项目中遇到更复杂的表格结构（如嵌套表格、不规则合并、单元格内混合内容等），可以在现有逻辑基础上进一步扩展。希望这篇文章能帮你快速上手，少走一些弯路。

到此这篇关于C#实现高效读取Word表格数据并导出为CSV/TXT的文章就介绍到这了,更多相关C#读取Word表格数据内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！