pip install openpyxl pillow

from openpyxl import Workbook
from openpyxl.drawing.image import Image
from openpyxl.worksheet.pagebreak import Break
from openpyxl.utils import get_column_letter

def create_pdf_friendly_report():
    wb = Workbook()
    ws = wb.active
    ws.title = "圖片不跨頁示例"

    # 假設(shè)我們有一組圖片路徑
    image_paths = ["chart1.png", "chart2.png", "chart3.png"] # 請確保目錄下有這些圖片，或替換為實(shí)際路徑
    
    current_row = 1
    
    for idx, img_path in enumerate(image_paths):
        try:
            img = Image(img_path)
        except FileNotFoundError:
            print(f"找不到圖片: {img_path}，跳過")
            continue

        # --- 核心步驟 1: 插入前置分頁符 (Before Break) ---
        # 如果不是第一張圖，我們在圖片開始前強(qiáng)制換頁，保證圖片從頁首開始
        if idx > 0:
            # 注意：Break 的 id 對應(yīng)的是行索引。
            # 在 current_row - 1 處打斷，意味著 current_row 將是新的一頁的開始
            page_break = Break(id=current_row - 1)
            ws.row_breaks.append(page_break)

        # --- 步驟 2: 放置圖片 ---
        # 定位單元格，例如 A1, A20, A40...
        cell_location = f"A{current_row}"
        ws.add_image(img, cell_location)
        
        # 添加一些描述文字（可選）
        ws[cell_location] = f"圖表 {idx + 1}: 銷售數(shù)據(jù)分析"

        # --- 步驟 3: 計(jì)算圖片占用的行數(shù) ---
        # 這是一個(gè)估算。Excel默認(rèn)行高約 15 像素（20 units）。
        # 我們需要根據(jù)圖片高度計(jì)算它大概跨越了多少行，以便更新 current_row
        # img.height 是像素值
        rows_to_skip = int(img.height / 20) + 2 # +2 是留一點(diǎn)余量
        
        # --- 核心步驟 4: 插入后置分頁符 (After Break) ---
        # 計(jì)算圖片結(jié)束的行
        end_row = current_row + rows_to_skip
        
        # 在圖片結(jié)束后強(qiáng)制換頁（如果你希望一頁只有一張圖）
        # 如果你希望緊接著放文字，這步可以省略，只依賴“前置分頁符”即可
        break_after = Break(id=end_row)
        ws.row_breaks.append(break_after)

        # 更新下一張圖的起始位置
        current_row = end_row + 1

    # 保存結(jié)果
    wb.save("完美分頁報(bào)表.xlsx")
    print("Excel 生成完畢，請打開打印預(yù)覽查看分頁效果。")

if __name__ == "__main__":
    # 為了演示，請先準(zhǔn)備幾張名為 chart1.png 等的圖片，或者修改代碼中的路徑
    create_pdf_friendly_report()

def insert_atomic_block(ws, img_path, title, start_row):
    """
    插入一個(gè)原子塊，并強(qiáng)制在塊之前分頁
    """
    # 1. 強(qiáng)制分頁（開啟新的一頁）
    if start_row > 1:
        ws.row_breaks.append(Break(id=start_row - 1))
    
    # 2. 寫入標(biāo)題
    ws.cell(row=start_row, column=1, value=title)
    
    # 3. 插入圖片
    img = Image(img_path)
    ws.add_image(img, f"A{start_row + 1}")
    
    # 4. 返回下一個(gè)可用的行號
    # 估算高度：標(biāo)題1行 + 圖片高度/20 + 余量
    height_rows = 1 + int(img.height / 20) + 2
    return start_row + height_rows