在数据处理与报表生成的日常开发中，我们经常需要调整 Excel 工作表的列顺序，以匹配下游系统的字段要求、优化数据展示结构或统一多份报表的列布局。手动拖拽调整在数据量小、文件少时可行，但面对批量文件或自动化流程时，就需要通过代码来程序化完成。

本文将介绍如何使用 .NET 平台下的免费 Excel 处理库，通过 C# 代码实现 Excel 列位置的调整与重排，不依赖 Microsoft Office 环境。

免费库可直接通过 NuGet 包管理器直接搜索 Free Spire.XLS 安装。

安装完成后，在代码文件顶部引入命名空间：

using Spire.Xls;

核心思路

Free Spire.XLS 并未直接提供一行代码即可重排列顺序的 API。实现这一功能的通用思路是：

1. 创建一个临时工作表，将目标工作表的完整数据复制进去
2. 按照新的列顺序，从临时工作表中逐列复制回目标工作表
3. 删除临时工作表

这种“先备份、再按序覆盖”的方式能够完整保留原有数据和列宽设置。

完整代码示例

using System.Linq;
using Spire.Xls;

namespace ReorderExcelColumns
{
    class Program
    {
        static void Main(string[] args)
        {
            // 1. 创建 Workbook 对象并加载 Excel 文件
            Workbook workbook = new Workbook();
            workbook.LoadFromFile(@"C:\sample.xlsx");

            // 2. 获取第一个工作表
            Worksheet worksheet = workbook.Worksheets[0];

            // 3. 定义新的列顺序（索引从0开始）
            // 示例：将原第4列(索引3)移到第1列，原第1-3列依次后移
            int[] newColumnOrder = new int[] { 3, 0, 1, 2, 4, 5 };

            // 4. 创建临时工作表并复制数据
            Worksheet tempSheet = workbook.Worksheets.Add("temp");
            tempSheet.CopyFrom(worksheet);

            // 5. 按新顺序将列从临时表复制回目标表
            for (int i = 0; i < newColumnOrder.Length; i++)
            {
                tempSheet.Columns[newColumnOrder[i]].Copy(
                    worksheet.Columns[i], 
                    true,   // 复制值
                    true    // 复制格式
                );
                // 6. 同步列宽
                worksheet.Columns[i].ColumnWidth = 
                    tempSheet.Columns[newColumnOrder[i]].ColumnWidth;
            }

            // 7. 删除临时工作表
            workbook.Worksheets.Remove(tempSheet);

            // 8. 保存工作簿
            workbook.SaveToFile("Reordered.xlsx", FileFormat.Version2016);
        }
    }
}

关键 API 说明

应用场景

• 批量整理表格结构：当需要对大量 Excel 文件执行相同的列顺序调整时
• 数据展示优化：将关键字段（如日期、ID）前置，提升可读性
• 自动化报表生成：在数据导出或报表生成流程中统一列顺序
• 数据迁移与整合：将不同来源的 Excel 数据调整为统一的列结构