git clone <repository-url>
cd 13-Excel批量樣式修改器

pip install openpyxl tkinterdnd2

python main.py

def beautify_one_file(file_path: str,
                      header_row: int,
                      header_font, header_fill,
                      data_font, data_fill,
                      center_header: bool,
                      center_data: bool,
                      change_header_bg: bool = True,
                      change_data_bg: bool = True,
                      sheet_names: list = None):

def get_sheet_names(file_path: str):

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
Excel 批量美化小工具
tkinter + openpyxl，支持拖拽
"""

import os
import sys
import threading
from tkinter import *
from tkinter import ttk, filedialog, messagebox
from tkinter.scrolledtext import ScrolledText

try:
    from tkinterdnd2 import DND_FILES, TkinterDnD
except ImportError:
    messagebox.showerror("依賴(lài)缺失", "請(qǐng)先 pip install tkinterdnd2")
    sys.exit(1)

from openpyxl import load_workbook
from openpyxl.styles import Alignment, Font, PatternFill


# ---------- 工具函數(shù) ----------
def get_sheet_names(file_path: str):
    """獲取Excel文件中所有Sheet的名稱(chēng)"""
    try:
        wb = load_workbook(file_path, read_only=True)
        sheet_names = [ws.title for ws in wb.worksheets]
        wb.close()
        return sheet_names
    except Exception as e:
        return []


def rgb_to_hex(r, g, b):
    """將 rgb 整數(shù)轉(zhuǎn) 16 進(jìn)制字符串"""
    return f"{r:02X}{g:02X}{b:02X}"


def hex_to_rgb(hex_color: str):
    """#RRGGBB 轉(zhuǎn) (r,g,b)"""
    hex_color = hex_color.lstrip("#")
    return tuple(int(hex_color[i:i + 2], 16) for i in (0, 2, 4))


# ---------- 核心邏輯 ----------
def beautify_one_file(file_path: str,
                      header_row: int,
                      header_font, header_fill,
                      data_font, data_fill,
                      center_header: bool,
                      center_data: bool,
                      change_header_bg: bool = True,
                      change_data_bg: bool = True,
                      sheet_names: list = None):
    """美化單個(gè)文件"""
    wb = load_workbook(file_path)
    # 如果指定了sheet_names，只處理指定的Sheet；否則處理所有Sheet
    if sheet_names:
        worksheets = [ws for ws in wb.worksheets if ws.title in sheet_names]
    else:
        worksheets = wb.worksheets
    
    for ws in worksheets:
        max_col = ws.max_column
        # ----- 表頭 -----
        for col in range(1, max_col + 1):
            cell = ws.cell(row=header_row, column=col)
            cell.font = header_font
            if change_header_bg:
                cell.fill = header_fill
            if center_header:
                cell.alignment = Alignment(horizontal='center', vertical='center')
        # ----- 數(shù)據(jù)行 -----
        for row in range(header_row + 1, ws.max_row + 1):
            for col in range(1, max_col + 1):
                cell = ws.cell(row=row, column=col)
                cell.font = data_font
                if change_data_bg:
                    cell.fill = data_fill
                if center_data:
                    cell.alignment = Alignment(horizontal='center', vertical='center')
    wb.save(file_path)


# ---------- GUI ----------
class ExcelBeautifier(TkinterDnD.Tk):
    def __init__(self):
        super().__init__()
        self.title("Excel 批量美化工具")
        self.geometry("700x600")
        self.resizable(False, False)
        self.file_list = []

        # ---- 頂部參數(shù)區(qū) ----
        params = LabelFrame(self, text="參數(shù)設(shè)置", padx=10, pady=10)
        params.pack(fill=X, padx=10, pady=5)

        # 表頭行號(hào)
        row_frm = Frame(params)
        row_frm.pack(anchor=W)
        Label(row_frm, text="表頭所在行號(hào)：").pack(side=LEFT)
        self.header_row_var = IntVar(value=1)
        Spinbox(row_frm, from_=1, to_=100, textvariable=self.header_row_var, width=5).pack(side=LEFT)

        # 表頭字體/字號(hào)/顏色/居中/背景色控制
        self.header_font_name = StringVar(value="微軟雅黑")
        self.header_font_size = IntVar(value=12)
        self.header_hex = StringVar(value="#4472C4")  # 默認(rèn)藍(lán)色
        self.center_header = BooleanVar(value=True)
        self.change_header_bg = BooleanVar(value=True)

        # 數(shù)據(jù)行字體/字號(hào)/顏色/居中/背景色控制
        self.data_font_name = StringVar(value="微軟雅黑")
        self.data_font_size = IntVar(value=10)
        self.data_hex = StringVar(value="#FFFFFF")
        self.center_data = BooleanVar(value=False)
        self.change_data_bg = BooleanVar(value=True)

        # Sheet選擇模式
        self.sheet_mode = StringVar(value="all")  # "all" 或 "specific"
        self.sheet_names_input = StringVar(value="")

        def _add_line(parent, label, font_name, font_size, hex_var, center_var, bg_var):
            frm = Frame(parent)
            frm.pack(anchor=W, pady=2)
            Label(frm, text=label, width=10, anchor=W).pack(side=LEFT)
            Label(frm, text="字體:").pack(side=LEFT)
            ttk.Combobox(frm, textvariable=font_name, values=["微軟雅黑", "宋體", "Arial", "Calibri"], width=10,
                         state="readonly").pack(side=LEFT)
            Label(frm, text="字號(hào):").pack(side=LEFT)
            Spinbox(frm, from_=6, to_=30, textvariable=font_size, width=5).pack(side=LEFT)
            Label(frm, text="背景色:").pack(side=LEFT)
            Entry(frm, textvariable=hex_var, width=8).pack(side=LEFT)
            Button(frm, text="選色", command=lambda: self.choose_color(hex_var)).pack(side=LEFT, padx=2)
            Checkbutton(frm, text="改變背景色", variable=bg_var).pack(side=LEFT, padx=2)
            Checkbutton(frm, text="水平居中", variable=center_var).pack(side=LEFT)

        _add_line(params, "表頭：", self.header_font_name, self.header_font_size, self.header_hex, self.center_header, self.change_header_bg)
        _add_line(params, "數(shù)據(jù)：", self.data_font_name, self.data_font_size, self.data_hex, self.center_data, self.change_data_bg)

        # Sheet選擇區(qū)域
        sheet_frm = Frame(params)
        sheet_frm.pack(anchor=W, pady=5)
        Label(sheet_frm, text="Sheet選擇：", width=10, anchor=W).pack(side=LEFT)
        Radiobutton(sheet_frm, text="處理所有Sheet", variable=self.sheet_mode, value="all",
                   command=self.on_sheet_mode_change).pack(side=LEFT)
        Radiobutton(sheet_frm, text="指定Sheet", variable=self.sheet_mode, value="specific",
                   command=self.on_sheet_mode_change).pack(side=LEFT, padx=10)
        Label(sheet_frm, text="Sheet名稱(chēng):").pack(side=LEFT)
        self.sheet_entry = Entry(sheet_frm, textvariable=self.sheet_names_input, width=20, 
                                state=DISABLED)
        self.sheet_entry.pack(side=LEFT, padx=2)
        Button(sheet_frm, text="查看Sheet", command=self.show_sheets).pack(side=LEFT, padx=2)
        Label(sheet_frm, text="(多個(gè)用逗號(hào)分隔)", font=("微軟雅黑", 8)).pack(side=LEFT)

        # ---- 文件列表區(qū) ----
        list_frame = LabelFrame(self, text="待處理文件（支持拖拽）", padx=10, pady=10)
        list_frame.pack(fill=BOTH, expand=True, padx=10, pady=5)
        self.listbox = Listbox(list_frame, selectmode=EXTENDED)
        self.listbox.pack(side=LEFT, fill=BOTH, expand=True)
        scroll = Scrollbar(list_frame, orient=VERTICAL)
        scroll.pack(side=RIGHT, fill=Y)
        self.listbox.config(yscrollcommand=scroll.set)
        scroll.config(command=self.listbox.yview)

        # 拖拽綁定
        self.listbox.drop_target_register(DND_FILES)
        self.listbox.dnd_bind('<<Drop>>', self.on_drop)

        # ---- 按鈕區(qū) ----
        btn_bar = Frame(self)
        btn_bar.pack(fill=X, padx=10, pady=5)
        Button(btn_bar, text="添加文件", command=self.add_files).pack(side=LEFT, padx=2)
        Button(btn_bar, text="添加目錄", command=self.add_folder).pack(side=LEFT, padx=2)
        Button(btn_bar, text="移除選中", command=self.remove_selected).pack(side=LEFT, padx=2)
        Button(btn_bar, text="清空列表", command=self.clear_list).pack(side=LEFT, padx=2)
        Button(btn_bar, text="開(kāi)始美化", command=self.start_task, bg="#4472C4", fg="white").pack(side=RIGHT, padx=2)

        # ---- 日志/進(jìn)度 ----
        bottom = Frame(self)
        bottom.pack(fill=X, padx=10, pady=5)
        self.log = ScrolledText(bottom, height=8, state=DISABLED)
        self.log.pack(fill=X)
        self.progress = ttk.Progressbar(bottom, orient=HORIZONTAL, mode='determinate')
        self.progress.pack(fill=X, pady=5)

    # ---------- 交互 ----------
    def on_sheet_mode_change(self):
        """Sheet選擇模式改變時(shí)的回調(diào)"""
        if self.sheet_mode.get() == "specific":
            self.sheet_entry.config(state=NORMAL)
        else:
            self.sheet_entry.config(state=DISABLED)
            self.sheet_names_input.set("")  # 清空輸入

    def show_sheets(self):
        """顯示選中文件的Sheet列表"""
        if not self.file_list:
            messagebox.showinfo("提示", "請(qǐng)先添加Excel文件！")
            return
        
        # 獲取第一個(gè)文件的Sheet列表作為示例
        file_path = self.file_list[0]
        sheet_names = get_sheet_names(file_path)
        
        if not sheet_names:
            messagebox.showerror("錯(cuò)誤", f"無(wú)法讀取文件：{os.path.basename(file_path)}")
            return
        
        # 顯示Sheet列表
        sheet_list = "\n".join([f"? {name}" for name in sheet_names])
        messagebox.showinfo(
            f"Sheet列表 - {os.path.basename(file_path)}",
            f"該文件包含以下Sheet：\n\n{sheet_list}\n\n提示：如需處理多個(gè)Sheet，請(qǐng)用逗號(hào)分隔"
        )

    def choose_color(self, var: StringVar):
        from tkinter.colorchooser import askcolor
        _, hex_code = askcolor(color=var.get(), parent=self)
        if hex_code:
            var.set(hex_code.upper())

    def on_drop(self, event):
        files = self.tk.splitlist(event.data)
        self.add_file_list(files)

    def add_files(self):
        files = filedialog.askopenfilenames(filetypes=[("Excel 文件", "*.xlsx")])
        self.add_file_list(files)

    def add_folder(self):
        folder = filedialog.askdirectory()
        if not folder:
            return
        files = [os.path.join(folder, f) for f in os.listdir(folder)
                 if f.lower().endswith(".xlsx")]
        self.add_file_list(files)

    def add_file_list(self, files):
        for f in files:
            if f not in self.file_list:
                self.file_list.append(f)
                self.listbox.insert(END, os.path.basename(f))

    def remove_selected(self):
        for idx in reversed(self.listbox.curselection()):
            self.listbox.delete(idx)
            self.file_list.pop(idx)

    def clear_list(self):
        self.listbox.delete(0, END)
        self.file_list.clear()

    def log_msg(self, msg: str):
        self.log.config(state=NORMAL)
        self.log.insert(END, msg + "\n")
        self.log.see(END)
        self.log.config(state=DISABLED)
        self.update()

    # ---------- 任務(wù) ----------
    def start_task(self):
        if not self.file_list:
            messagebox.showwarning("提示", "請(qǐng)先添加待處理文件！")
            return
        # 禁用按鈕防止重復(fù)點(diǎn)擊
        for child in self.winfo_children():
            if isinstance(child, Frame):
                for btn in child.winfo_children():
                    if isinstance(btn, Button):
                        btn.config(state=DISABLED)
        self.progress["maximum"] = len(self.file_list)
        self.progress["value"] = 0
        threading.Thread(target=self.worker, daemon=True).start()

    def worker(self):
        hdr_font = Font(name=self.header_font_name.get(), size=self.header_font_size.get(), bold=True)
        hdr_rgb = hex_to_rgb(self.header_hex.get())
        hdr_fill = PatternFill(start_color=rgb_to_hex(*hdr_rgb), end_color=rgb_to_hex(*hdr_rgb), fill_type="solid")

        dat_font = Font(name=self.data_font_name.get(), size=self.data_font_size.get(), bold=False)
        dat_rgb = hex_to_rgb(self.data_hex.get())
        dat_fill = PatternFill(start_color=rgb_to_hex(*dat_rgb), end_color=rgb_to_hex(*dat_rgb), fill_type="solid")

        # 處理Sheet選擇
        sheet_names = None
        if self.sheet_mode.get() == "specific":
            sheet_input = self.sheet_names_input.get().strip()
            if sheet_input:
                sheet_names = [name.strip() for name in sheet_input.split(',') if name.strip()]

        for idx, file_path in enumerate(self.file_list, 1):
            self.log_msg(f"[{idx}/{len(self.file_list)}] 處理中：{os.path.basename(file_path)}")
            try:
                beautify_one_file(
                    file_path,
                    self.header_row_var.get(),
                    hdr_font, hdr_fill,
                    dat_font, dat_fill,
                    self.center_header.get(),
                    self.center_data.get(),
                    self.change_header_bg.get(),
                    self.change_data_bg.get(),
                    sheet_names
                )
                self.log_msg("  完成！")
            except Exception as e:
                self.log_msg(f"  錯(cuò)誤：{e}")
            self.progress["value"] = idx

        self.log_msg(">>> 全部任務(wù)結(jié)束！")
        # 恢復(fù)按鈕
        for child in self.winfo_children():
            if isinstance(child, Frame):
                for btn in child.winfo_children():
                    if isinstance(btn, Button):
                        btn.config(state=NORMAL)


# ---------- 啟動(dòng) ----------
if __name__ == "__main__":
    ExcelBeautifier().mainloop()