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 = "圖片不跨頁(yè)示例"

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

        # --- 核心步驟 1: 插入前置分頁(yè)符 (Before Break) ---
        # 如果不是第一張圖，我們?cè)趫D片開(kāi)始前強(qiáng)制換頁(yè)，保證圖片從頁(yè)首開(kāi)始
        if idx > 0:
            # 注意：Break 的 id 對(duì)應(yīng)的是行索引。
            # 在 current_row - 1 處打斷，意味著 current_row 將是新的一頁(yè)的開(kāi)始
            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: 插入后置分頁(yè)符 (After Break) ---
        # 計(jì)算圖片結(jié)束的行
        end_row = current_row + rows_to_skip
        
        # 在圖片結(jié)束后強(qiáng)制換頁(yè)（如果你希望一頁(yè)只有一張圖）
        # 如果你希望緊接著放文字，這步可以省略，只依賴“前置分頁(yè)符”即可
        break_after = Break(id=end_row)
        ws.row_breaks.append(break_after)

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

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

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

def insert_atomic_block(ws, img_path, title, start_row):
    """
    插入一個(gè)原子塊，并強(qiáng)制在塊之前分頁(yè)
    """
    # 1. 強(qiáng)制分頁(yè)（開(kāi)啟新的一頁(yè)）
    if start_row > 1:
        ws.row_breaks.append(Break(id=start_row - 1))
    
    # 2. 寫(xiě)入標(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è)可用的行號(hào)
    # 估算高度：標(biāo)題1行 + 圖片高度/20 + 余量
    height_rows = 1 + int(img.height / 20) + 2
    return start_row + height_rows