Python如何設置Excel單元格邊框

更新時間：2025年04月20日 08:12:04 作者：Eiceblue

在數(shù)據(jù)驅(qū)動的業(yè)務場景中,自動化設置Excel單元格邊框成為提升數(shù)據(jù)處理效率的關鍵環(huán)節(jié),下面我們就來講講如何使用Python設置Excel工作簿中單元格的邊框吧

在數(shù)據(jù)驅(qū)動的業(yè)務場景中，自動化設置Excel單元格邊框成為提升數(shù)據(jù)處理效率的關鍵環(huán)節(jié)。通過程序化控制邊框樣式，不僅能確保海量報表格式的統(tǒng)一性，還能通過粗細、虛實等視覺元素強化數(shù)據(jù)邏輯層次。當面對動態(tài)更新的分析報告時，代碼驅(qū)動的邊框規(guī)則可自適應內(nèi)容變化，避免人工反復調(diào)整的誤差風險，同時為數(shù)據(jù)可視化建立可復用的標準化框架。本文將介紹如何使用Python設置Excel工作簿中單元格的邊框。

本文所使用的方法需要用到Free Spire.XLS for Python，PyPI：pip install spire.xls。

用Python設置Excel內(nèi)邊框和外邊框

庫中提供的CellRange.BorderAround()方法和CellRange.BoderInside()方法可分別用于直接對指定單元格范圍設置邊框，并可指定邊框樣式和顏色。以下是操作步驟：

Excel 單元格區(qū)域設置內(nèi)邊框與外邊框的操作步驟

1.導入必要的類

使用以下類：

Workbook：表示 Excel 工作簿
LineStyleType：定義邊框的樣式（如 Thick、Thin）
ExcelColors：提供預定義顏色用于邊框

2.創(chuàng)建 Workbook 實例并加載文件

使用 Workbook() 創(chuàng)建工作簿對象，使用 LoadFromFile(path) 方法加載現(xiàn)有的 Excel 文件。

3.獲取工作表

通過 Workbook.Worksheets.get_Item(index) 方法獲取指定的工作表。

4.選定需要設置邊框的單元格區(qū)域

使用 sheet.Range.get_Item(startRow, startCol, endRow, endCol) 方法指定區(qū)域范圍。

5.設置外邊框

使用 Range.BorderAround(lineStyle, color) 方法為區(qū)域設置外邊框。

lineStyle 為 LineStyleType 枚舉值
color 為 ExcelColors 枚舉值

6.設置內(nèi)邊框

使用 Range.BorderInside(lineStyle, color) 方法為區(qū)域設置內(nèi)部的行列邊框。
適用于表格區(qū)域或多行多列的區(qū)域設置。

7.保存和釋放資源

使用 SaveToFile(path) 方法保存文件，使用 Dispose() 方法釋放資源。

代碼示例

from spire.xls import Workbook, LineStyleType, ExcelColors

# 創(chuàng)建Workbook對象
workbook = Workbook()

# 載入Excel文件
workbook.LoadFromFile("Sample.xlsx")

# 獲取第一個工作表
sheet = workbook.Worksheets.get_Item(0)

# 獲取標題和表頭行
headerRow = sheet.Range.get_Item(1, 1, 2, sheet.Range.ColumnCount)
# 設置標題和表頭外邊框
headerRow.BorderAround(LineStyleType.Thick, ExcelColors.BlueGray)

# 獲取數(shù)據(jù)行
dataRows = sheet.Range.get_Item(3, 1, sheet.Range.RowCount, sheet.Range.ColumnCount)
# 設置數(shù)據(jù)行內(nèi)邊框
dataRows.BorderInside(LineStyleType.Thin, ExcelColors.BrightGreen)

# 保存工作簿
workbook.SaveToFile("output/OutsideInsideBorders.xlsx")
workbook.Dispose()

輸出的文檔

用Python設置單元格上下左右邊框

庫中還提供了CellRange.Style.Borders.get_Item()方法來訪問單元格區(qū)域的上下左右以及斜線邊框，并可通過LineStyle和Color等屬性來對邊框樣式進行自定義。以下是添加上下左右以及斜線邊框到單元格區(qū)域的操作步驟：

設置單元格或行的單側(cè)邊框的操作步驟

1.導入必要的類

使用以下類：

Workbook：表示 Excel 工作簿
BordersLineType：枚舉，用于指定邊框類型（如 EdgeTop, EdgeBottom 等）
LineStyleType：邊框線條樣式（如 Thick, Dashed 等）
Color：用于設置邊框顏色（可通過 Color.get_XXX() 獲取預定義顏色）

2.創(chuàng)建 Workbook 實例并加載 Excel 文件

創(chuàng)建對象：workbook = Workbook()
加載文件：workbook.LoadFromFile(path)

3.獲取工作表

使用 Workbook.Worksheets.get_Item(index) 獲取目標工作表。

4.選定目標單元格或整行

獲取行：sheet.Rows.get_Item(rowIndex)
獲取單元格：sheet.Range.get_Item(row, column)

5.設置邊框樣式與顏色

獲取邊框?qū)ο螅?/p>

style = target.Style.Borders.get_Item(BordersLineType.XXX)

XXX 可為：

EdgeTop（上邊框）
EdgeBottom（下邊框）
EdgeLeft（左邊框）
EdgeRight（右邊框）
DiagonalUp（斜上線）
DiagonalDown（斜下線）

設置線型與顏色：

style.LineStyle = LineStyleType.XXX
style.Color = Color.get_XXX()

6.保存文件并釋放資源

使用 SaveToFile(path) 保存更改，使用 Dispose() 釋放資源。

代碼示例

from spire.xls import Workbook, BordersLineType, LineStyleType, Color

# 創(chuàng)建Workbook對象
workbook = Workbook()

# 載入Excel文件
workbook.LoadFromFile("Sample.xlsx")

# 獲取第一個工作表
sheet = workbook.Worksheets.get_Item(0)

# 獲取第二行
row2 = sheet.Rows.get_Item(1)
# 設置下邊框
row2.Style.Borders.get_Item(BordersLineType.EdgeBottom).LineStyle = LineStyleType.Thick
row2.Style.Borders.get_Item(BordersLineType.EdgeBottom).Color = Color.get_White()

# 獲取第四行
row4 = sheet.Rows.get_Item(3)
# 設置上邊框
row4.Style.Borders.get_Item(BordersLineType.EdgeTop).LineStyle = LineStyleType.Dotted
row4.Style.Borders.get_Item(BordersLineType.EdgeTop).Color = Color.get_Red()

# 獲取第六行第二個單元格
cell1 = sheet.Range.get_Item(6, 2)
# 設置左邊框
cell1.Style.Borders.get_Item(BordersLineType.EdgeLeft).LineStyle = LineStyleType.DashDotDot
cell1.Style.Borders.get_Item(BordersLineType.EdgeLeft).Color = Color.get_Blue()

# 獲取第八行第二個單元格
cell2 = sheet.Range.get_Item(8, 2)
# 設置右邊框
cell2.Style.Borders.get_Item(BordersLineType.EdgeRight).LineStyle = LineStyleType.Dashed
cell2.Style.Borders.get_Item(BordersLineType.EdgeRight).Color = Color.get_Brown()

# 獲取第十行
row10 = sheet.Rows.get_Item(9)
# 設置下斜線邊框
row10.Style.Borders.get_Item(BordersLineType.DiagonalDown).LineStyle = LineStyleType.Double
row10.Style.Borders.get_Item(BordersLineType.DiagonalDown).Color = Color.get_Yellow()

# 獲取第十二行
row12 = sheet.Rows.get_Item(11)
# 設置上斜線邊框
row12.Style.Borders.get_Item(BordersLineType.DiagonalUp).LineStyle = LineStyleType.Medium
row12.Style.Borders.get_Item(BordersLineType.DiagonalUp).Color = Color.get_Aqua()

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

輸出的文檔