在 Excel 報表中，為行設置交替背景色（又稱“鑲邊行”或“帶狀行”）是一種常見的視覺優化手段。它可以幫助用户更容易分辨行數據，提高表格的可讀性，尤其在處理財務表格、銷售報表或大型數據列表時非常有用。

本文將詳細介紹如何使用 Free Spire.XLS for Python 來為 Excel 設置交替行色。我們將提供三種實現方法，並講解每種方法的技術細節、優勢和適用場景。

安裝依賴

pip install spire.xls.free

本文所使用的演示Excel表格如下：

方法一：使用條件格式（Conditional Formatting）

條件格式是 Excel 提供的動態格式化功能，可以基於單元格的值或公式自動應用樣式。通過條件公式 MOD(ROW(),2)，可以判斷行號的奇偶性，從而實現交替行背景色。

from spire.xls import Workbook, Color, ConditionalFormatType

# 1. 載入 Excel 文件
workbook = Workbook()
workbook.LoadFromFile("Sample7.xlsx")

# 2. 獲取工作表和數據區域
sheet = workbook.Worksheets.get_Item(0)
cellRange = sheet.Range.get_Item(3, 1, sheet.LastRow, sheet.LastColumn)

# 3. 添加條件格式對象並應用到數據區域
formats = sheet.ConditionalFormats.Add()
formats.AddRange(cellRange)

# 4. 設置偶數行條件格式
conditional1 = formats.AddCondition()
conditional1.FormatType = ConditionalFormatType.Formula
conditional1.FirstFormula = "=MOD(ROW(),2)=0"
conditional1.BackColor = Color.get_LightGray()

# 5. 設置奇數行條件格式
conditional2 = formats.AddCondition()
conditional2.FormatType = ConditionalFormatType.Formula
conditional2.FirstFormula = "=MOD(ROW(),2)=1"
conditional2.BackColor = Color.get_LightPink()

# 6. 保存文件
workbook.SaveToFile("output/ConditionalFormatting.xlsx")
workbook.Dispose()

技術細節解析

• Workbook：表示 Excel 工作簿，LoadFromFile 用於加載文件，SaveToFile 保存文件。
• Worksheet：工作表對象，通過 workbook.Worksheets.get_Item(index) 獲取。
• Range：單元格區域，通過 sheet.Range.get_Item(startRow, startCol, endRow, endCol) 獲取。
• ConditionalFormats：工作表條件格式集合，用 Add() 添加格式規則。
• ConditionalFormatType.Formula：通過公式判斷條件是否成立，FirstFormula 設置公式字符串。
• BackColor：設置單元格背景色。

結果展示：

優勢：

• 自動應用於新增或排序後的行，無需額外操作。
• 可通過公式自定義更復雜的邏輯（如每三行、每五行變色）。
• 對數據結構影響小，不改變原有單元格內容或表格對象。

方法二：使用內置表格樣式（Table Styles）

Excel 內置表格樣式提供了自帶“帶狀行”的視覺效果，可以快速美化數據區域。Spire.XLS 提供了 ListObjects 和 BuiltInTableStyle 支持。

from spire.xls import Workbook, TableBuiltInStyles

# 1. 載入 Excel 文件
workbook = Workbook()
workbook.LoadFromFile("G:/Document/Sample7.xlsx")

# 2. 獲取工作表和數據區域
sheet = workbook.Worksheets.get_Item(0)
cellRange = sheet.Range.get_Item(2, 1, sheet.LastRow, sheet.LastColumn)

# 3. 將區域創建為表格對象
table = sheet.ListObjects.Create("table", cellRange)

# 4. 應用內置表格樣式（帶狀行效果）
table.BuiltInTableStyle = TableBuiltInStyles.TableStyleMedium2

# 5. 保存文件
workbook.SaveToFile("output/TableStyle.xlsx")
workbook.Dispose()

技術細節解析

• ListObjects.Create(name, range)：將指定區域創建為表格對象（類似 Excel 中“插入表格”）。
• BuiltInTableStyle：設置表格樣式，帶有表頭、邊框、交替行色等效果。
• TableBuiltInStyles：Spire.XLS 提供的內置表格樣式枚舉，可快速調用。

效果展示：

優勢：

• 一行代碼即可生成漂亮的帶狀行表格。
• 表格樣式自動包括表頭加粗、邊框和交替行色。
• 插入新行時顏色自動更新。

限制：表格對象可能對已有複雜格式或合併單元格有限制。

方法三：自定義循環設置行背景色

通過循環遍歷每一行並直接設置 Row.Style.Color，可以完全控制交替行的顏色，適合對單元格進行個性化定製。

from spire.xls import Workbook, Color

# 1. 載入 Excel 文件
workbook = Workbook()
workbook.LoadFromFile("G:/Document/Sample7.xlsx")

# 2. 獲取工作表
sheet = workbook.Worksheets.get_Item(0)

# 3. 循環設置交替行背景色
for i in range(2, sheet.LastRow):
    style = sheet.Rows.get_Item(i).Style
    style.Color = Color.get_LightGray() if i % 2 == 0 else Color.get_LightSkyBlue()

# 4. 保存文件
workbook.SaveToFile("output/CustomStyle.xlsx")
workbook.Dispose()

技術細節解析

• Rows.get_Item(index)：獲取指定行對象。
• Row.Style.Color：設置該行所有單元格的背景色。
• 循環邏輯：i % 2 == 0 用於判斷行號奇偶，實現交替顏色。

效果展示：

優勢：

• 自由度最高，可自定義任意配色或規則。
• 對已有表格結構無依賴，適合複雜或不規則的數據區域。

限制：新插入行不會自動應用，需要重新執行腳本。

三種方法對比

總結

本文展示了三種方法在 Python 中為 Excel 設置交替行色（鑲邊行 / 帶狀行）的實現方式：

1. 條件格式：適合動態報表，自動更新，靈活性高。
2. 表格樣式：快速美觀，操作簡單，但靈活性有限。
3. 自定義循環：可完全自定義，適合複雜業務邏輯，但新行需手動處理。

通過掌握 Workbook、Worksheet、Range、ConditionalFormats、ListObjects 等核心類，以及 Style.Color、BuiltInTableStyle 等關鍵屬性，你可以根據業務需求選擇最合適的方式，實現 Excel 自動化美化，提高報表可讀性和專業性。

更多 Excel 文件處理技巧請前往 Spire.XLS for Python 官方教程查看。