引言

很多 Python 學(xué)習(xí)者在接觸辦公自動(dòng)化時(shí)，都會(huì)很自然地想到一個(gè)需求：能不能用 Python 批量處理 Excel，并自動(dòng)生成一份像樣的統(tǒng)計(jì)報(bào)表？

如果你的目標(biāo)是“高質(zhì)量地生成 Excel 文件”，那么 XlsxWriter 是一個(gè)非常值得掌握的庫(kù)。它特別適合做這些事情：

• 批量寫(xiě)入 Excel 數(shù)據(jù)
• 設(shè)置單元格格式和樣式
• 寫(xiě)公式
• 插入圖表
• 生成日?qǐng)?bào)、周報(bào)、月報(bào)
• 輸出適合直接交付的統(tǒng)計(jì)報(bào)表

不過(guò)在正式開(kāi)始之前，我先把一個(gè)關(guān)鍵點(diǎn)講清楚：

XlsxWriter 的強(qiáng)項(xiàng)是創(chuàng)建和寫(xiě)出 Excel 文件，它不負(fù)責(zé)讀取已有的 .xlsx 文件。

也就是說(shuō)，如果你需要“讀取舊 Excel 再修改”，更適合用 openpyxl；如果你已經(jīng)有了 Python 中的數(shù)據(jù)，想高質(zhì)量輸出一個(gè)新 Excel 報(bào)表，XlsxWriter 往往會(huì)更順手。

這篇文章會(huì)帶你系統(tǒng)掌握 XlsxWriter 的核心用法，并通過(guò)一個(gè)完整案例，學(xué)會(huì)如何自動(dòng)生成一份統(tǒng)計(jì)報(bào)表。

1. XlsxWriter 是什么

XlsxWriter 是一個(gè)專門(mén)用于創(chuàng)建 Excel .xlsx 文件的 Python 庫(kù)。

它適合這些典型場(chǎng)景：

• 把 Python 里的列表、字典、統(tǒng)計(jì)結(jié)果寫(xiě)成 Excel
• 自動(dòng)生成格式統(tǒng)一的業(yè)務(wù)報(bào)表
• 創(chuàng)建帶公式、條件格式、圖表的工作簿
• 輸出給同事、領(lǐng)導(dǎo)、客戶直接查看的 Excel 文件

和 openpyxl 相比，XlsxWriter 的定位更聚焦在“生成結(jié)果文件”這一端。

簡(jiǎn)單理解：

• openpyxl：更適合“讀 + 改 + 保存”
• XlsxWriter：更適合“從 0 開(kāi)始生成一份漂亮的 Excel”

2. 先說(shuō)結(jié)論：它為什么不適合讀取已有 Excel

很多初學(xué)者看到名字時(shí)，會(huì)自然以為它和 openpyxl 一樣，既能讀也能寫(xiě)。

但實(shí)際情況是：

• XlsxWriter 可以創(chuàng)建新的 .xlsx
• 可以寫(xiě)工作表、寫(xiě)單元格、寫(xiě)公式、寫(xiě)圖表
• 不能打開(kāi)一個(gè)已有 Excel 文件再去讀取內(nèi)容

所以如果你的原始數(shù)據(jù)已經(jīng)在：

• Python 列表
• 字典
• 數(shù)據(jù)庫(kù)查詢結(jié)果
• CSV 文件
• pandas.DataFrame

那么 XlsxWriter 就很好用。

如果你的原始數(shù)據(jù)只存在于“某個(gè)現(xiàn)成 Excel 文件”里，通常會(huì)這樣組合：

• 用 openpyxl 或 pandas 讀取數(shù)據(jù)
• 用 XlsxWriter 負(fù)責(zé)輸出最終報(bào)表

這也是實(shí)際工作中很常見(jiàn)的做法。

3. 安裝 XlsxWriter

安裝命令很簡(jiǎn)單：

pip install XlsxWriter

導(dǎo)入方式如下：

import xlsxwriter

如果沒(méi)有報(bào)錯(cuò)，就說(shuō)明安裝成功了。

4. 先認(rèn)識(shí)幾個(gè)核心對(duì)象

用 XlsxWriter 時(shí)，最常見(jiàn)的對(duì)象有 3 個(gè)：

• Workbook：整個(gè) Excel 文件
• Worksheet：工作表
• Format：?jiǎn)卧窀袷綄?duì)象

可以理解為：

Workbook -> Worksheet -> Cell Data + Format

其中 Format 很重要，因?yàn)?XlsxWriter 很擅長(zhǎng)做“格式化輸出”。

5. 最基礎(chǔ)的 Excel 寫(xiě)入示例

先看一個(gè)最小可運(yùn)行示例：

import xlsxwriter

workbook = xlsxwriter.Workbook("sales_demo.xlsx")
worksheet = workbook.add_worksheet("銷(xiāo)售數(shù)據(jù)")

worksheet.write("A1", "日期")
worksheet.write("B1", "銷(xiāo)售員")
worksheet.write("C1", "地區(qū)")
worksheet.write("D1", "銷(xiāo)售額")

worksheet.write("A2", "2026-04-01")
worksheet.write("B2", "張三")
worksheet.write("C2", "華東")
worksheet.write("D2", 5800)

worksheet.write_row("A3", ["2026-04-01", "李四", "華北", 7200])
worksheet.write_row("A4", ["2026-04-02", "王五", "華南", 4300])

workbook.close()

運(yùn)行后，你會(huì)得到一個(gè) sales_demo.xlsx 文件。

這里你可以先記住兩個(gè)寫(xiě)法：

• write()：寫(xiě)單個(gè)單元格
• write_row()：按一整行寫(xiě)入

如果你有大量二維數(shù)據(jù)，write_row() 會(huì)很方便。

6. 如何設(shè)置單元格樣式

XlsxWriter 很大的優(yōu)勢(shì)之一，就是對(duì) Excel 格式控制比較友好。

比如我們給表頭加粗、加背景色：

import xlsxwriter

workbook = xlsxwriter.Workbook("format_demo.xlsx")
worksheet = workbook.add_worksheet("示例")

header_format = workbook.add_format({
    "bold": True,
    "font_color": "white",
    "bg_color": "#4F81BD",
    "align": "center",
    "valign": "vcenter",
    "border": 1,
})

worksheet.write("A1", "姓名", header_format)
worksheet.write("B1", "部門(mén)", header_format)
worksheet.write("C1", "工資", header_format)

workbook.close()

你會(huì)發(fā)現(xiàn)，Format 對(duì)象是統(tǒng)一復(fù)用的。也就是說(shuō)：

• 先定義格式
• 再在多個(gè)單元格上重復(fù)使用

這在生成正式報(bào)表時(shí)很常見(jiàn)。

7. 如何寫(xiě)公式和數(shù)字格式

自動(dòng)報(bào)表往往離不開(kāi)公式和金額格式。

例如：

import xlsxwriter

workbook = xlsxwriter.Workbook("formula_demo.xlsx")
worksheet = workbook.add_worksheet("統(tǒng)計(jì)")

money_format = workbook.add_format({"num_format": "#,##0.00"})

worksheet.write("A1", "金額1")
worksheet.write("A2", "金額2")
worksheet.write_number("B1", 5800, money_format)
worksheet.write_number("B2", 7200, money_format)
worksheet.write_formula("B3", "=SUM(B1:B2)", money_format)

workbook.close()

這里的重點(diǎn)是：

• write_number()：明確按數(shù)字寫(xiě)入
• write_formula()：寫(xiě) Excel 公式
• num_format：控制金額、百分比、日期等顯示格式

8. 為什么 XlsxWriter 特別適合生成統(tǒng)計(jì)報(bào)表

很多 Excel 自動(dòng)化任務(wù)，本質(zhì)上不是“改老表”，而是“把已有數(shù)據(jù)生成一份新報(bào)表”。

例如：

• 根據(jù)訂單數(shù)據(jù)生成銷(xiāo)售統(tǒng)計(jì)表
• 根據(jù)考勤數(shù)據(jù)生成月度匯總
• 根據(jù)財(cái)務(wù)記錄生成對(duì)賬表
• 根據(jù)業(yè)務(wù)數(shù)據(jù)輸出周報(bào)和圖表

這時(shí)候 XlsxWriter 很合適，因?yàn)樗谶@些方面表現(xiàn)不錯(cuò)：

• 新文件生成流程清晰
• 樣式控制方便
• 圖表支持實(shí)用
• 適合做結(jié)構(gòu)化輸出

如果你想把腳本結(jié)果做成“領(lǐng)導(dǎo)能直接打開(kāi)看”的 Excel 文件，它很有價(jià)值。

9. 實(shí)戰(zhàn)案例：自動(dòng)生成銷(xiāo)售統(tǒng)計(jì)報(bào)表

下面我們做一個(gè)完整示例。

注意，這次我們不從 Excel 讀取源數(shù)據(jù)，而是模擬“你的業(yè)務(wù)數(shù)據(jù)已經(jīng)在 Python 中”。這更符合 XlsxWriter 的真實(shí)定位。

9.1 業(yè)務(wù)數(shù)據(jù)結(jié)構(gòu)

假設(shè)程序里已經(jīng)有一批銷(xiāo)售明細(xì)：

我們的目標(biāo)是輸出一個(gè) sales_report_xlsxwriter.xlsx，其中包含：

• 原始訂單明細(xì) Sheet
• 統(tǒng)計(jì)報(bào)表 Sheet
• 總訂單數(shù)、總銷(xiāo)售額、平均訂單金額
• 按銷(xiāo)售員匯總
• 按地區(qū)匯總
• 銷(xiāo)售員業(yè)績(jī)柱狀圖

10. 完整代碼示例

下面這段代碼可以直接運(yùn)行：

from collections import defaultdict
import xlsxwriter


sales_data = [
    ["2026-04-01", "張三", "華東", "鍵盤(pán)", 5800],
    ["2026-04-01", "李四", "華北", "顯示器", 7200],
    ["2026-04-02", "張三", "華東", "鼠標(biāo)", 1600],
    ["2026-04-02", "王五", "華南", "筆記本", 12500],
    ["2026-04-03", "李四", "華北", "擴(kuò)展塢", 2300],
    ["2026-04-03", "趙六", "華東", "耳機(jī)", 3600],
    ["2026-04-04", "王五", "華南", "平板", 8900],
    ["2026-04-04", "張三", "華東", "支架", 900],
]


def build_report(output_file):
    workbook = xlsxwriter.Workbook(output_file)

    detail_sheet = workbook.add_worksheet("訂單明細(xì)")
    summary_sheet = workbook.add_worksheet("統(tǒng)計(jì)報(bào)表")

    header_format = workbook.add_format({
        "bold": True,
        "font_color": "white",
        "bg_color": "#4F81BD",
        "align": "center",
        "valign": "vcenter",
        "border": 1,
    })

    title_format = workbook.add_format({
        "bold": True,
        "font_size": 16,
    })

    money_format = workbook.add_format({
        "num_format": "#,##0.00",
        "border": 1,
    })

    text_format = workbook.add_format({
        "border": 1,
    })

    bold_format = workbook.add_format({
        "bold": True,
    })

    headers = ["日期", "銷(xiāo)售員", "地區(qū)", "產(chǎn)品", "銷(xiāo)售額"]

    for col, header in enumerate(headers):
        detail_sheet.write(0, col, header, header_format)

    for row_num, row_data in enumerate(sales_data, start=1):
        for col_num, value in enumerate(row_data):
            if col_num == 4:
                detail_sheet.write_number(row_num, col_num, value, money_format)
            else:
                detail_sheet.write(row_num, col_num, value, text_format)

    detail_sheet.set_column("A:A", 14)
    detail_sheet.set_column("B:C", 12)
    detail_sheet.set_column("D:D", 14)
    detail_sheet.set_column("E:E", 14)

    seller_total = defaultdict(float)
    region_total = defaultdict(float)
    total_amount = 0
    order_count = 0

    for sale_date, seller, region, product, amount in sales_data:
        seller_total[seller] += amount
        region_total[region] += amount
        total_amount += amount
        order_count += 1

    avg_amount = total_amount / order_count if order_count else 0

    summary_sheet.write("A1", "銷(xiāo)售統(tǒng)計(jì)報(bào)表", title_format)

    summary_sheet.write("A3", "總訂單數(shù)", bold_format)
    summary_sheet.write("B3", order_count)
    summary_sheet.write("A4", "總銷(xiāo)售額", bold_format)
    summary_sheet.write_number("B4", total_amount, money_format)
    summary_sheet.write("A5", "平均訂單金額", bold_format)
    summary_sheet.write_number("B5", avg_amount, money_format)

    summary_sheet.write("A7", "按銷(xiāo)售員匯總", bold_format)
    summary_sheet.write("A8", "銷(xiāo)售員", header_format)
    summary_sheet.write("B8", "銷(xiāo)售額", header_format)

    seller_start_row = 8
    seller_items = sorted(seller_total.items(), key=lambda item: item[1], reverse=True)
    for index, (seller, amount) in enumerate(seller_items, start=1):
        summary_sheet.write(seller_start_row + index, 0, seller, text_format)
        summary_sheet.write_number(seller_start_row + index, 1, amount, money_format)

    region_title_row = seller_start_row + len(seller_items) + 3
    summary_sheet.write(region_title_row, 0, "按地區(qū)匯總", bold_format)
    summary_sheet.write(region_title_row + 1, 0, "地區(qū)", header_format)
    summary_sheet.write(region_title_row + 1, 1, "銷(xiāo)售額", header_format)

    region_items = sorted(region_total.items(), key=lambda item: item[1], reverse=True)
    for index, (region, amount) in enumerate(region_items, start=1):
        summary_sheet.write(region_title_row + 1 + index, 0, region, text_format)
        summary_sheet.write_number(region_title_row + 1 + index, 1, amount, money_format)

    summary_sheet.set_column("A:A", 16)
    summary_sheet.set_column("B:B", 14)
    summary_sheet.set_column("D:J", 12)

    chart = workbook.add_chart({"type": "column"})
    chart.add_series({
        "name": "銷(xiāo)售員業(yè)績(jī)",
        "categories": ["統(tǒng)計(jì)報(bào)表", seller_start_row + 1, 0, seller_start_row + len(seller_items), 0],
        "values": ["統(tǒng)計(jì)報(bào)表", seller_start_row + 1, 1, seller_start_row + len(seller_items), 1],
    })
    chart.set_title({"name": "銷(xiāo)售員業(yè)績(jī)統(tǒng)計(jì)"})
    chart.set_x_axis({"name": "銷(xiāo)售員"})
    chart.set_y_axis({"name": "銷(xiāo)售額"})
    chart.set_style(10)

    summary_sheet.insert_chart("D3", chart, {"x_scale": 1.3, "y_scale": 1.2})

    workbook.close()


if __name__ == "__main__":
    build_report("sales_report_xlsxwriter.xlsx")
    print("統(tǒng)計(jì)報(bào)表已生成：sales_report_xlsxwriter.xlsx")

11. 這段代碼做了什么

如果你是初學(xué)者，建議重點(diǎn)看下面幾部分。

第一步：準(zhǔn)備業(yè)務(wù)數(shù)據(jù)

這里我們直接把原始數(shù)據(jù)放在 sales_data 列表里。

這其實(shí)很符合很多真實(shí)項(xiàng)目的情況，因?yàn)閿?shù)據(jù)不一定來(lái)自 Excel，也可能來(lái)自：

• 數(shù)據(jù)庫(kù)查詢結(jié)果
• 接口返回值
• CSV 文件
• pandas 處理后的結(jié)果

而 XlsxWriter 負(fù)責(zé)的是最后的“導(dǎo)出報(bào)表”。

第二步：定義格式對(duì)象

代碼里創(chuàng)建了這些格式：

• header_format
• title_format
• money_format
• text_format
• bold_format

這是 XlsxWriter 很典型的寫(xiě)法。你通常會(huì)先把各種格式定義好，再批量應(yīng)用到不同單元格。

第三步：寫(xiě)入明細(xì)表

程序先把訂單明細(xì)寫(xiě)進(jìn) 訂單明細(xì) 這個(gè) Sheet。

其中金額列使用了：

detail_sheet.write_number(row_num, col_num, value, money_format)

這樣 Excel 會(huì)把它按數(shù)值看待，而不是按文本。

第四步：統(tǒng)計(jì)匯總

這里使用 defaultdict(float) 來(lái)統(tǒng)計(jì)：

• 每個(gè)銷(xiāo)售員的總銷(xiāo)售額
• 每個(gè)地區(qū)的總銷(xiāo)售額
• 所有訂單的總金額
• 平均訂單金額

這是自動(dòng)報(bào)表里最常見(jiàn)的一類邏輯。

第五步：插入圖表

這一步是 XlsxWriter 的強(qiáng)項(xiàng)之一。

通過(guò)：

chart = workbook.add_chart({"type": "column"})

你可以很方便地生成柱狀圖、折線圖等圖表，并插入到報(bào)表中。

12. 運(yùn)行后能得到什么結(jié)果

運(yùn)行腳本后，你會(huì)得到一個(gè)：

• sales_report_xlsxwriter.xlsx

其中包含：

• 原始明細(xì)表
• 統(tǒng)計(jì)報(bào)表
• 總訂單數(shù)
• 總銷(xiāo)售額
• 平均訂單金額
• 銷(xiāo)售員匯總
• 地區(qū)匯總
• 柱狀圖

對(duì)于很多辦公自動(dòng)化需求來(lái)說(shuō)，這已經(jīng)是一份能直接交付使用的 Excel 報(bào)表了。

13. XlsxWriter 的典型應(yīng)用場(chǎng)景

如果你在工作里經(jīng)常遇到以下任務(wù)，XlsxWriter 非常值得學(xué)：

• 把程序統(tǒng)計(jì)結(jié)果導(dǎo)出成 Excel
• 生成帶格式的日?qǐng)?bào)、周報(bào)、月報(bào)
• 輸出財(cái)務(wù)匯總表
• 生成銷(xiāo)售績(jī)效報(bào)表
• 做項(xiàng)目數(shù)據(jù)周報(bào)
• 導(dǎo)出接口數(shù)據(jù)給業(yè)務(wù)同事查看

一句話總結(jié)：

當(dāng)你的重點(diǎn)是“把數(shù)據(jù)優(yōu)雅地輸出成 Excel 文件”時(shí)，XlsxWriter 很合適。

14. XlsxWriter 和 OpenPyXL 怎么選

很多初學(xué)者都會(huì)問(wèn)這個(gè)問(wèn)題。

可以這樣記：

更適合用 XlsxWriter 的情況

• 你要新建 Excel 文件
• 你要輸出格式化報(bào)表
• 你要插入圖表和公式
• 你的原始數(shù)據(jù)已經(jīng)在 Python 中

更適合用 OpenPyXL 的情況

• 你要讀取已有 Excel
• 你要修改舊工作簿
• 你要基于已有模板做細(xì)粒度修改

如果你把兩者分工理解清楚，選型就不會(huì)亂。

15. 使用 XlsxWriter 的幾個(gè)注意點(diǎn)

15.1 它不讀取已有.xlsx

這一點(diǎn)最重要。不要把它當(dāng)成“萬(wàn)能 Excel 庫(kù)”。

15.2 別忘了workbook.close()

如果不關(guān)閉工作簿，文件可能不會(huì)正確寫(xiě)出。

15.3 數(shù)字、字符串、公式最好分開(kāi)寫(xiě)

像 write_number()、write_string()、write_formula() 這樣的 API，語(yǔ)義更清楚，也更利于報(bào)表結(jié)果穩(wěn)定。

15.4 復(fù)雜數(shù)據(jù)處理最好先在 Python 里完成

XlsxWriter 的定位是“輸出”。復(fù)雜清洗、轉(zhuǎn)換、聚合最好先在 Python 邏輯里算好，再交給它寫(xiě)到 Excel。

16. 總結(jié)

XlsxWriter 是一個(gè)非常適合做 Excel 報(bào)表輸出的 Python 庫(kù)。

它最強(qiáng)的地方不是“讀取現(xiàn)有工作簿”，而是：

• 把已有數(shù)據(jù)寫(xiě)成結(jié)構(gòu)化 Excel
• 控制樣式和格式
• 插入公式和圖表
• 自動(dòng)生成可直接交付的統(tǒng)計(jì)報(bào)表

如果你經(jīng)常需要把程序結(jié)果導(dǎo)出給別人看，或者想把重復(fù)的表格匯總工作自動(dòng)化，XlsxWriter 很值得掌握。

對(duì)于 Python 學(xué)習(xí)者來(lái)說(shuō)，它也是一個(gè)很好的練手方向，因?yàn)槟隳芎芸彀汛a變成實(shí)際成果。

17. 留言互動(dòng)

你現(xiàn)在更常遇到的是哪一類 Excel 需求：

• 讀取舊表并修改
• 直接生成新報(bào)表
• 批量導(dǎo)出業(yè)務(wù)數(shù)據(jù)
• 做帶圖表的匯總文件

如果你愿意，我下一篇可以繼續(xù)寫(xiě)更實(shí)戰(zhàn)一點(diǎn)的內(nèi)容，比如：

• pandas + XlsxWriter 自動(dòng)導(dǎo)出多 Sheet 報(bào)表
• 用 XlsxWriter 生成帶條件格式的財(cái)務(wù)報(bào)表
• openpyxl 和 XlsxWriter 的實(shí)際選型對(duì)比

也歡迎你直接留言說(shuō)說(shuō)：你現(xiàn)在最想自動(dòng)化掉的 Excel 工作，到底是哪一種？

以上就是Python使用XlsxWriter生成Excel并自動(dòng)輸出統(tǒng)計(jì)報(bào)表的詳細(xì)內(nèi)容，更多關(guān)于Python XlsxWriter生成Excel并自動(dòng)輸出的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論