本文介绍了使用 PyInstaller 打包 Python 程序时常见的包依赖问题及解决方案。涵盖隐藏子模块缺失、sys.stdin 丢失、图标格式错误、返回值不匹配及依赖检查失效等问题。提供了使用--collect-all、--hidden-import、GUI 对话框替代 input() 以及 spec 文件配置等方法。同时附带了完整的 Excel 转换工具示例代码，帮助开发者解决打包过程中的实际困难。
作为一名 Python 开发者，将代码打包成独立的可执行文件（EXE）分发给用户是一个常见需求。PyInstaller 是最流行的打包工具之一，但在实际使用中，包依赖问题常常让人头疼。以下通过一个真实的 Excel 转换工具案例，总结 PyInstaller 打包过程中遇到的各种包依赖问题及其解决方案。
我们需要将一个 Python GUI 程序打包成 EXE，该程序功能包括：
依赖库：openpyxl, xlwt, tkinter, PIL
错误信息：
ModuleNotFoundError: No module named 'openpyxl.cell._writer'
原因分析： 某些 Python 包（如 openpyxl）使用动态导入或隐藏的子模块，PyInstaller 的静态分析无法检测到这些模块。
解决方案：
# 方案 1：使用 --collect-all（推荐）
pyinstaller --onefile --windowed --name="程序名" --collect-all openpyxl your_script.py
# 方案 2：手动添加所有可能的隐藏导入
pyinstaller --onefile --windowed --name="程序名" \
--hidden-import=openpyxl \
--hidden-import=openpyxl.cell._writer \
--hidden-import=openpyxl.cell.rich_text \
--hidden-import=openpyxl.worksheet._writer \
your_script.py
错误信息：
RuntimeError: input(): lost sys.stdin
原因分析：
在 --windowed（无控制台）模式下，input() 函数无法使用，因为标准输入流被关闭。
解决方案：
方案 1：移除或替换 input() 调用
# 修改前的代码
def check_dependencies():
response = input("是否安装依赖？(y/n): ")
# ...
# 修改后的代码
def check_dependencies():
# EXE 模式下跳过依赖检查
if getattr(sys, 'frozen', False):
return True
# 仅在脚本模式下检查
# ...
方案 2：使用 GUI 对话框替代
import tkinter as tk
from tkinter import messagebox
def ask_user(prompt):
root = tk.Tk()
root.withdraw()
response = messagebox.askyesno("提示", prompt)
root.destroy()
return response
错误信息：
ValueError: Received icon image 'favicon.ico' which exists but is not in the correct format
原因分析： 图标文件不是有效的 .ico 格式，或者 PyInstaller 需要 Pillow 库来转换图标。
解决方案：
# 1. 安装 Pillow
pip install pillow
# 2. 创建正确的 ICO 文件
from PIL import Image, ImageDraw
# 创建多尺寸图标
sizes = [256, 128, 64, 48, 32, 16]
images = []
for size in sizes:
img = Image.new('RGBA', (size, size), color='blue')
images.append(img)
images[0].save('app.ico', format='ICO', append_images=images[1:])
# 3. 重新打包
pyinstaller --onefile --windowed --name="程序名" --icon=app.ico your_script.py
错误信息：
not enough values to unpack (expected 5, got 2)
原因分析： 函数在不同情况下返回不同数量的值，但在调用处期望固定数量的返回值。
解决方案：
# 修改前的代码
success, result, stats1, stats2, stats3 = convert_file(...)
# 修改后的代码
result = convert_file(...)
if isinstance(result, tuple):
if len(result) == 2:
success, message = result
# 设置默认值
stats1, stats2, stats3 = 0, 0, 0
elif len(result) >= 5:
success, message, stats1, stats2, stats3 = result[:5]
else:
success, message = False, "返回值格式错误"
错误信息：
openpyxl 未安装，请运行：pip install openpyxl
原因分析： 代码中的依赖检查逻辑没有区分 EXE 模式和脚本模式。
解决方案：
def check_dependencies():
"""智能依赖检查"""
# 判断是否在 EXE 中运行
is_exe = getattr(sys, 'frozen', False) and hasattr(sys, '_MEIPASS')
if is_exe:
# EXE 模式：所有依赖已打包
print("运行在 EXE 模式，依赖已包含")
# 验证关键模块
try:
import openpyxl
print(f"✓ openpyxl 已包含")
return True
except ImportError:
print("✗ openpyxl 未找到")
return False
# 脚本模式：执行依赖检查
# ... 原有的依赖检查逻辑 ...
@echo off
chcp 65001>nul
echo ============================================
echo 程序打包脚本
echo ============================================
echo.
echo [1/5] 清理环境...
rmdir /s /q build dist 2>nul
del *.spec 2>nul
echo.
echo [2/5] 安装依赖...
pip install -r requirements.txt
echo.
echo [3/5] 检查代码中的潜在问题...
findstr /n "input(" your_script.py
findstr /n "__import__" your_script.py
findstr /n "importlib" your_script.py
echo.
echo [4/5] 开始打包...
pyinstaller --onefile --windowed ^
--name="你的程序" ^
--icon=app.ico ^
--collect-all openpyxl ^
--collect-all other_package ^
--hidden-import=tkinter ^
--hidden-import=PIL ^
--clean ^
--noupx ^
your_script.py
echo.
echo [5/5] 验证打包结果...
if exist "dist\你的程序.exe"(
echo ✓ 打包成功！
echo.
echo 文件位置：dist\你的程序.exe
) else (
echo ✗ 打包失败！
)
pause
# requirements.txt
openpyxl>=3.1.0
xlwt>=1.3.0
Pillow>=10.0.0
创建 program.spec 文件进行精细控制：
# -*- mode: python ; coding: utf-8 -*-
block_cipher = None
a = Analysis(['your_script.py'], pathex=[], binaries=[], datas=[], hiddenimports=['openpyxl','openpyxl.cell._writer','openpyxl.cell.rich_text','openpyxl.worksheet._writer','xlwt','tkinter','PIL','PIL._tkinter_finder',], hookspath=[], hooksconfig={}, runtime_hooks=[], excludes=['test','tests','unittest','pydoc','tkinter.test',], win_no_prefer_redirects=False, win_private_assemblies=False, cipher=block_cipher, noarchive=False,)
pyz = PYZ(a.pure, a.zipped_data, cipher=block_cipher)
exe = EXE(
pyz, a.scripts, a.binaries, a.datas,[], name='你的程序', debug=False, bootloader_ignore_signals=False, strip=False, upx=True, upx_exclude=[], runtime_tmpdir=None, console=False, icon='app.ico', disable_windowed_traceback=False, argv_emulation=False, target_arch=None, codesign_identity=None, entitlements_file=None,)
coll = COLLECT(
exe, a.binaries, a.datas, strip=False, upx=True, upx_exclude=[], name='你的程序',)
如果你的代码使用动态导入，确保添加到 --hidden-import：
# 动态导入示例
module_name = "openpyxl.styles.numbers"
module = __import__(module_name, fromlist=[''])
# 或者使用 importlib
import importlib
module = importlib.import_module("openpyxl.worksheet._writer")
对应的打包命令：
pyinstaller --onefile --windowed --name="程序名" \
--hidden-import=openpyxl.styles.numbers \
--hidden-import=openpyxl.worksheet._writer \
your_script.py
| 问题 | 症状 | 解决方案 |
|---|---|---|
| 模块找不到 | ModuleNotFoundError | 使用 --collect-all 或 --hidden-import |
| input() 错误 | lost sys.stdin | 移除或替换 input()，或使用 --console |
| 图标错误 | 图标格式不正确 | 安装 Pillow，创建有效的 ICO 文件 |
| EXE 太大 | 文件体积过大 | 使用 --exclude-module 排除不需要的模块 |
| 启动慢 | EXE 启动时间长 | 使用 --onefile 但不用 --upx |
| 依赖检查失败 | 提示模块未安装 | 修改代码区分 EXE/脚本模式 |
| 路径问题 | 找不到资源文件 | 使用 sys._MEIPASS 访问打包的资源 |
pyinstaller --debug=all your_script.py
pyinstaller --debug=imports your_script.py
打包后查看 build/程序名/warn-程序名.txt
# test_exe.py
import sys
print("Python 路径:", sys.executable)
print("运行模式:", "EXE" if getattr(sys, 'frozen', False) else "脚本")
# 测试关键模块
try:
import openpyxl
print("✓ openpyxl 可导入")
except ImportError as e:
print(f"✗ openpyxl 导入失败：{e}")
# 列出所有已导入的模块
print("\n已导入的模块:")
for m in sorted(sys.modules):
if 'openpyxl' in m or 'xlwt' in m:
print(f" {m}")
通过这个 Excel 转换工具的实际案例，我们总结了 PyInstaller 打包过程中最常见的依赖问题：
--collect-all 是最可靠的解决方案input()/print()--hidden-import记住这些经验，下次打包 Python 程序时就能少走弯路。PyInstaller 虽然强大，但理解其工作原理和常见陷阱，才能让它更好地为我们服务。
最后的小贴士：如果遇到难以解决的问题，尝试搜索 PyInstaller + 包名 + hidden import，很可能已经有人遇到过相同的问题并找到了解决方案。
本文总结了常见问题与解决方案。
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
""" Excel 格式转换程序 - 带日期时间后缀版本 输出文件名自动添加日期时间避免重复 """
import os
import sys
from datetime import datetime
import tkinter as tk
from tkinter import ttk, filedialog, scrolledtext, messagebox
import threading
import openpyxl
import xlwt
from openpyxl import load_workbook
from openpyxl import Workbook
from openpyxl.styles import Font, Alignment, NamedStyle
from openpyxl.styles.numbers import FORMAT_NUMBER_COMMA_SEPARATED1
class ExcelConverterPure:
"""完全不使用 pandas 的 Excel 转换器"""
def __init__(self):
# 输入文件列定义
self.input_columns = ['交易时间', '交易对手户名', '交易对手账号', '交易对手行名', '借贷标志', '交易金额', '交易后余额', '币种', '交易类型', '用途', '摘要']
# 输出文件列定义
self.output_columns = ['交易时间', '贷方发生额/元 (收入)', '对方户名', '对方账号', '备注']
# 列映射关系
self.column_mapping = {
'交易时间': '交易时间',
'交易金额': '贷方发生额/元 (收入)',
'交易对手户名': '对方户名',
'交易对手账号': '对方账号',
'用途': '备注'
}
def convert_time_format(self, time_str):
"""转换时间格式：2026-02-02 14:58:01 → 20260202 14:58:01"""
if not time_str:
return ''
time_str = str(time_str).strip()
if not time_str:
return ''
try:
# 尝试多种日期格式
date_formats = ['%Y-%m-%d %H:%M:%S', '%Y/%m/%d %H:%M:%S', '%Y-%m-%d', '%Y/%m/%d']
for fmt in date_formats:
try:
dt = datetime.strptime(time_str, fmt)
if ':' in time_str:
return dt.strftime('%Y%m%d %H:%M:%S')
else:
return dt.strftime('%Y%m%d')
except ValueError:
continue
# 如果无法解析，返回原字符串
return time_str
except Exception:
return time_str
def generate_timestamp_filename(self, original_path, file_format):
"""生成带时间戳的文件名
参数:
original_path: 原始文件路径
file_format: 文件格式 ('xls' 或 'xlsx')
返回:
str: 带时间戳的新文件路径
"""
# 获取当前日期时间
now = datetime.now()
timestamp = now.strftime("%Y%m%d_%H%M%S")
# 格式：20240215_143025
# 获取目录和文件名
dir_path = os.path.dirname(original_path)
base_name = os.path.basename(original_path)
# 分离文件名和扩展名
if '.' in base_name:
name_without_ext, old_ext = os.path.splitext(base_name)
# 移除可能已有的_converted 后缀
if name_without_ext.endswith('_converted'):
name_without_ext = name_without_ext[:-10]
# 移除最后 10 个字符
else:
name_without_ext = base_name
# 生成新文件名
new_filename = f"{name_without_ext}_converted_{timestamp}.{file_format}"
# 组合完整路径
new_path = os.path.join(dir_path, new_filename)
return new_path
def get_unique_filename(self, file_path):
"""获取唯一的文件名，如果文件已存在则添加序号
参数:
file_path: 文件路径
返回:
str: 唯一的文件路径
"""
if not os.path.exists(file_path):
return file_path
# 如果文件已存在，添加序号
dir_path = os.path.dirname(file_path)
base_name = os.path.basename(file_path)
# 分离文件名和扩展名
name_without_ext, ext = os.path.splitext(base_name)
counter = 1
while True:
new_filename = f"{name_without_ext}_{counter}{ext}"
new_path = os.path.join(dir_path, new_filename)
if not os.path.exists(new_path):
return new_path
counter += 1
def parse_numeric_value(self, value):
"""解析数值，转换为浮点数"""
if value is None:
return 0.0
value_str = str(value).strip()
# 移除可能的货币符号、千位分隔符等
value_str = value_str.replace('¥', '').replace('￥', '').replace('$', '').replace('€', '')
value_str = value_str.replace(',', '').replace('，', '')
# 如果为空或非数字
if not value_str:
return 0.0
try:
# 尝试转换为浮点数
return float(value_str)
except ValueError:
# 如果不是数字，返回 0
return 0.0
def read_xlsx_file(self, filepath):
"""读取.xlsx 文件，不使用 pandas"""
try:
# # 尝试导入 openpyxl
# try:
# from openpyxl import load_workbook
# except ImportError:
# return False, "openpyxl 未安装，请运行：pip install openpyxl"
# 加载工作簿
wb = openpyxl.load_workbook(filepath, data_only=True)
ws = wb.active
# 读取数据
data = []
headers = []
# 第 9 行是标题行（索引从 1 开始）
for row in ws.iter_rows(min_row=9, max_row=9, values_only=True):
headers = [str(cell).strip() if cell else '' for cell in row]
break
# 验证标题行
missing_cols = []
for col in self.input_columns:
if col not in headers:
missing_cols.append(col)
if missing_cols:
return False, f"缺少必需的列：{', '.join(missing_cols)}", None
# 从第 10 行开始读取数据
for row in ws.iter_rows(min_row=10, values_only=True):
# 创建字典
row_dict = {}
for i, header in enumerate(headers):
if i < len(row):
row_dict[header] = row[i]
else:
row_dict[header] = ''
data.append(row_dict)
wb.close()
return True, f"读取成功，共{len(data)}行", data
except Exception as e:
return False, f"读取文件失败：{str(e)}", None
def save_to_xls(self, data, output_path):
"""保存数据到.xls 文件，使用 xlwt，确保数值类型正确"""
try:
# 尝试导入 xlwt
# try:
# import xlwt
# except ImportError:
# return False, "xlwt 未安装，请运行：pip install xlwt"
# 创建工作簿
workbook = xlwt.Workbook(encoding='utf-8')
worksheet = workbook.add_sheet('Sheet1')
# 设置样式
# 标题样式
header_style = xlwt.XFStyle()
header_font = xlwt.Font()
header_font.bold = True
header_style.font = header_font
# 数值样式（带千位分隔符，两位小数）
number_style = xlwt.XFStyle()
number_format = '#,##0.00'
# 千位分隔符，两位小数
number_style.num_format_str = number_format
# 常规文本样式
text_style = xlwt.XFStyle()
# 写入标题行
for col_idx, col_name in enumerate(self.output_columns):
worksheet.write(0, col_idx, col_name, header_style)
# 设置列宽
if col_idx == 0:
# 交易时间
worksheet.col(col_idx).width = 256 * 20
elif col_idx == 1:
# 贷方发生额
worksheet.col(col_idx).width = 256 * 18
elif col_idx == 2:
# 对方户名
worksheet.col(col_idx).width = 256 * 25
elif col_idx == 3:
# 对方账号
worksheet.col(col_idx).width = 256 * 20
elif col_idx == 4:
# 备注
worksheet.col(col_idx).width = 256 * 30
# 写入数据
for row_idx, row_data in enumerate(data, start=1):
# 1. 交易时间（文本）
time_val = row_data.get('交易时间', '')
worksheet.write(row_idx, 0, self.convert_time_format(time_val), text_style)
# 2. 贷方发生额（数值型，第 2 列）
amount_val = row_data.get('交易金额', '')
numeric_amount = self.parse_numeric_value(amount_val)
worksheet.write(row_idx, 1, numeric_amount, number_style)
# 3. 对方户名（文本）
name_val = row_data.get('交易对手户名', '')
worksheet.write(row_idx, 2, str(name_val), text_style)
# 4. 对方账号（文本）
account_val = row_data.get('交易对手账号', '')
worksheet.write(row_idx, 3, str(account_val), text_style)
# 5. 备注（文本）
remark_val = row_data.get('用途', '')
worksheet.write(row_idx, 4, str(remark_val), text_style)
# 保存文件
workbook.save(output_path)
return True, f"保存成功：{output_path}"
except Exception as e:
return False, f"保存文件失败：{str(e)}"
def save_to_xlsx(self, data, output_path):
"""保存数据到.xlsx 文件，使用 openpyxl，确保数值类型正确"""
try:
# 尝试导入 openpyxl
# try:
# from openpyxl import Workbook
# from openpyxl.styles import Font, Alignment, NamedStyle
# from openpyxl.styles.numbers import FORMAT_NUMBER_COMMA_SEPARATED1
# except ImportError:
# return False, "openpyxl 未安装，请运行：pip install openpyxl"
# 创建工作簿
wb = Workbook()
ws = wb.active
ws.title = "Sheet1"
# 创建数值样式（带千位分隔符，两位小数）
number_style = NamedStyle(name="currency_style")
number_style.number_format = FORMAT_NUMBER_COMMA_SEPARATED1
# 写入标题行
for col_idx, col_name in enumerate(self.output_columns, start=1):
cell = ws.cell(row=1, column=col_idx, value=col_name)
cell.font = Font(bold=True)
# 设置列宽
if col_idx == 1:
# 交易时间
ws.column_dimensions['A'].width = 20
elif col_idx == 2:
# 贷方发生额
ws.column_dimensions['B'].width = 18
elif col_idx == 3:
# 对方户名
ws.column_dimensions['C'].width = 25
elif col_idx == 4:
# 对方账号
ws.column_dimensions['D'].width = 20
elif col_idx == 5:
# 备注
ws.column_dimensions['E'].width = 30
# 写入数据
for row_idx, row_data in enumerate(data, start=2):
# 1. 交易时间（A 列）
time_val = row_data.get('交易时间', '')
cell_time = ws.cell(row=row_idx, column=1, value=self.convert_time_format(time_val))
# 2. 贷方发生额（B 列，数值型）
amount_val = row_data.get('交易金额', '')
numeric_amount = self.parse_numeric_value(amount_val)
cell_amount = ws.cell(row=row_idx, column=2, value=numeric_amount)
# 应用数值样式（带千位分隔符）
if numeric_amount != 0:
cell_amount.style = number_style
# 如果是货币，可以添加前缀
# cell_amount.number_format = '¥#,##0.00' # 人民币符号
cell_amount.number_format = '#,##0.00'
# 不带符号
# 3. 对方户名（C 列）
name_val = row_data.get('交易对手户名', '')
ws.cell(row=row_idx, column=3, value=str(name_val))
# 4. 对方账号（D 列）
account_val = row_data.get('交易对手账号', '')
ws.cell(row=row_idx, column=4, value=str(account_val))
# 5. 备注（E 列）
remark_val = row_data.get('用途', '')
ws.cell(row=row_idx, column=5, value=str(remark_val))
# 保存文件
wb.save(output_path)
return True, f"保存成功：{output_path}"
except Exception as e:
return False, f"保存文件失败：{str(e)}"
def filter_and_convert_data(self, data):
"""筛选借贷标志为'贷'的数据，并预处理数值"""
filtered_data = []
for row in data:
# 获取借贷标志
debit_credit = str(row.get('借贷标志', '')).strip()
# 如果借贷标志为'贷'，则保留
if debit_credit == '贷':
# 预处理交易金额，确保转换为数值
if '交易金额' in row:
row['交易金额'] = self.parse_numeric_value(row['交易金额'])
filtered_data.append(row)
return filtered_data
def convert_file(self, input_path, output_path, use_timestamp, log_callback=None):
"""转换文件主函数"""
def log(msg):
if log_callback:
log_callback(msg)
try:
# 1. 验证输入文件
if not os.path.exists(input_path):
return False, f"输入文件不存在：{input_path}", 0, 0, 0
if not input_path.lower().endswith('.xlsx'):
return False, "输入文件必须是.xlsx 格式", 0, 0, 0
# 2. 读取文件
log("正在读取输入文件...")
success, message, data = self.read_xlsx_file(input_path)
if not success:
return False, message, 0, 0, 0
log(f"读取成功，共 {len(data)} 行数据")
# 3. 筛选数据
log("正在筛选数据（借贷标志='贷'）...")
filtered_data = self.filter_and_convert_data(data)
log(f"筛选出 {len(filtered_data)} 行符合条件的记录")
if len(filtered_data) == 0:
return False, "没有找到借贷标志为'贷'的记录", 0, 0, 0
# 4. 设置输出路径
if not output_path:
# 自动生成输出文件名
input_dir = os.path.dirname(input_path)
input_name = os.path.splitext(os.path.basename(input_path))[0]
# 根据输出格式决定扩展名
if 'format_choice' in self.__dict__ and self.format_choice == 'xls':
ext = 'xls'
else:
ext = 'xls'
# 默认.xls
# 生成基本文件名
base_filename = f"{input_name}_converted.{ext}"
output_path = os.path.join(input_dir, base_filename)
# 5. 如果需要时间戳，生成带时间戳的文件名
if use_timestamp:
# 获取文件格式
if output_path.lower().endswith('.xls'):
file_format = 'xls'
elif output_path.lower().endswith('.xlsx'):
file_format = 'xlsx'
else:
file_format = 'xls'
# 默认
# 生成带时间戳的文件名
output_path = self.generate_timestamp_filename(output_path, file_format)
log(f"使用带时间戳的文件名：{os.path.basename(output_path)}")
# 6. 确保文件名唯一（即使使用时间戳也检查）
output_path = self.get_unique_filename(output_path)
# 7. 保存文件
log(f"正在保存文件：{output_path}")
# 根据文件扩展名选择保存方法
if output_path.lower().endswith('.xls'):
success, message = self.save_to_xls(filtered_data, output_path)
else:
# 默认保存为.xlsx
if not output_path.lower().endswith('.xlsx'):
output_path += '.xlsx'
success, message = self.save_to_xlsx(filtered_data, output_path)
if success:
log("转换完成！")
# 统计金额总和
total_amount = 0
for row in filtered_data:
if '交易金额' in row:
try:
total_amount += float(row['交易金额'])
except:
pass
log(f"总金额：{total_amount:,.2f}")
return True, output_path, len(data), len(filtered_data), total_amount
else:
return False, message, len(data), len(filtered_data), 0
except Exception as e:
return False, f"转换过程中出现错误：{str(e)}", 0, 0, 0
class ExcelConverterGUI:
"""GUI 界面"""
def __init__(self):
self.root = tk.Tk()
self.converter = ExcelConverterPure()
self.setup_ui()
def setup_ui(self):
"""设置用户界面"""
self.root.title("Excel 格式转换程序 - 带时间戳版本")
self.root.geometry("950x750")
self.root.resizable(True, True)
# 设置字体
default_font = ('微软雅黑', 10)
self.root.option_add('*Font', default_font)
# 创建主框架
main_frame = ttk.Frame(self.root, padding="10")
main_frame.grid(row=0, column=0, sticky=(tk.W, tk.E, tk.N, tk.S))
# 配置网格权重
self.root.columnconfigure(0, weight=1)
self.root.rowconfigure(0, weight=1)
main_frame.columnconfigure(1, weight=1)
# 标题
title_label = ttk.Label(main_frame, text="Excel 格式转换程序（带时间戳版本）", font=('微软雅黑', 16, 'bold'))
title_label.grid(row=0, column=0, columnspan=3, pady=(0, 20))
# 输入文件选择
ttk.Label(main_frame, text="输入文件 (.xlsx):").grid(row=1, column=0, sticky=tk.W, pady=5)
self.input_path = tk.StringVar()
input_entry = ttk.Entry(main_frame, textvariable=self.input_path, width=60)
input_entry.grid(row=1, column=1, sticky=(tk.W, tk.E), padx=5, pady=5)
input_btn = ttk.Button(main_frame, text="浏览...", command=self.browse_input)
input_btn.grid(row=1, column=2, padx=(5, 0), pady=5)
# 输出文件选择
ttk.Label(main_frame, text="输出文件:").grid(row=2, column=0, sticky=tk.W, pady=5)
self.output_path = tk.StringVar()
output_entry = ttk.Entry(main_frame, textvariable=self.output_path, width=60)
output_entry.grid(row=2, column=1, sticky=(tk.W, tk.E), padx=5, pady=5)
output_btn = ttk.Button(main_frame, text="浏览...", command=self.browse_output)
output_btn.grid(row=2, column=2, padx=(5, 0), pady=5)
# 格式选项
self.format_var = tk.StringVar(value="xls")
format_frame = ttk.LabelFrame(main_frame, text="输出格式设置", padding="10")
format_frame.grid(row=3, column=0, columnspan=3, sticky=(tk.W, tk.E), pady=10)
# 格式选择
ttk.Radiobutton(format_frame, text="Excel 97-2003 (.xls)", variable=self.format_var, value="xls").pack(side=tk.LEFT, padx=10)
ttk.Radiobutton(format_frame, text="Excel 2007+ (.xlsx)", variable=self.format_var, value="xlsx").pack(side=tk.LEFT, padx=10)
# 数值格式选项
self.number_format_var = tk.StringVar(value="plain")
ttk.Label(format_frame, text="数值格式:").pack(side=tk.LEFT, padx=(20, 5))
ttk.Radiobutton(format_frame, text="普通数字", variable=self.number_format_var, value="plain").pack(side=tk.LEFT, padx=5)
ttk.Radiobutton(format_frame, text="千位分隔符", variable=self.number_format_var, value="comma").pack(side=tk.LEFT, padx=5)
ttk.Radiobutton(format_frame, text="货币格式", variable=self.number_format_var, value="currency").pack(side=tk.LEFT, padx=5)
# 文件名选项
options_frame = ttk.LabelFrame(main_frame, text="文件名选项", padding="10")
options_frame.grid(row=4, column=0, columnspan=3, sticky=(tk.W, tk.E), pady=10)
# 时间戳选项
self.timestamp_var = tk.BooleanVar(value=True)
timestamp_check = ttk.Checkbutton(options_frame, text="添加日期时间后缀 (避免重复)", variable=self.timestamp_var)
timestamp_check.pack(anchor=tk.W, padx=5, pady=2)
# 示例说明
example_label = ttk.Label(options_frame, text="示例：原文件 → 输出文件_converted_20240215_143025.xls", font=('微软雅黑', 8))
example_label.pack(anchor=tk.W, padx=5, pady=2)
# 日志区域
ttk.Label(main_frame, text="转换日志:").grid(row=5, column=0, sticky=tk.W, pady=(10, 5))
# 创建带滚动条的文本框
log_frame = ttk.Frame(main_frame)
log_frame.grid(row=6, column=0, columnspan=3, sticky=(tk.W, tk.E, tk.N, tk.S), pady=(0, 10))
# 配置 log_frame 的网格权重
log_frame.columnconfigure(0, weight=1)
log_frame.rowconfigure(0, weight=1)
# 创建 Text 控件和 Scrollbar
self.log_text = scrolledtext.ScrolledText(log_frame, width=85, height=18, font=('Consolas', 9))
self.log_text.grid(row=0, column=0, sticky=(tk.W, tk.E, tk.N, tk.S))
# 统计信息区域
stats_frame = ttk.LabelFrame(main_frame, text="转换统计", padding="10")
stats_frame.grid(row=7, column=0, columnspan=3, sticky=(tk.W, tk.E), pady=5)
self.stats_text = tk.Text(stats_frame, width=85, height=4, font=('Consolas', 9))
self.stats_text.pack()
self.stats_text.insert(tk.END, "等待转换...")
self.stats_text.config(state='disabled')
# 控制按钮
button_frame = ttk.Frame(main_frame)
button_frame.grid(row=8, column=0, columnspan=3, pady=10)
self.convert_btn = ttk.Button(button_frame, text="开始转换", command=self.start_conversion)
self.convert_btn.pack(side=tk.LEFT, padx=5)
self.clear_btn = ttk.Button(button_frame, text="清空日志", command=self.clear_log)
self.clear_btn.pack(side=tk.LEFT, padx=5)
self.preview_btn = ttk.Button(button_frame, text="预览文件名", command=self.preview_filename)
self.preview_btn.pack(side=tk.LEFT, padx=5)
self.exit_btn = ttk.Button(button_frame, text="退出", command=self.root.quit)
self.exit_btn.pack(side=tk.LEFT, padx=5)
# 进度条
self.progress = ttk.Progressbar(main_frame, mode='indeterminate')
self.progress.grid(row=9, column=0, columnspan=3, sticky=(tk.W, tk.E), pady=10)
# 状态栏
self.status_var = tk.StringVar(value="就绪")
status_bar = ttk.Label(main_frame, textvariable=self.status_var, relief=tk.SUNKEN, anchor=tk.W)
status_bar.grid(row=10, column=0, columnspan=3, sticky=(tk.W, tk.E), pady=(5, 0))
# 配置主框架网格权重
main_frame.rowconfigure(6, weight=1)
def log(self, message):
"""添加日志消息"""
timestamp = datetime.now().strftime("%H:%M:%S")
log_message = f"[{timestamp}] {message}\n"
self.log_text.insert(tk.END, log_message)
self.log_text.see(tk.END)
# 自动滚动到底部
self.root.update_idletasks()
def update_stats(self, message):
"""更新统计信息"""
self.stats_text.config(state='normal')
self.stats_text.delete(1.0, tk.END)
self.stats_text.insert(tk.END, message)
self.stats_text.config(state='disabled')
def clear_log(self):
"""清空日志"""
self.log_text.delete(1.0, tk.END)
self.log("日志已清空")
self.update_stats("等待转换...")
def browse_input(self):
"""浏览输入文件"""
filepath = filedialog.askopenfilename(
title="选择输入文件",
filetypes=[("Excel 文件", "*.xlsx"), ("所有文件", "*.*")])
if filepath:
self.input_path.set(filepath)
self.log(f"选择输入文件：{filepath}")
# 自动生成输出文件名
if not self.output_path.get():
self.generate_output_filename()
def browse_output(self):
"""浏览输出文件"""
ext = self.format_var.get()
filetypes = [("Excel 文件", f"*.{ext}"), ("所有文件", "*.*")]
filepath = filedialog.asksaveasfilename(
title="选择输出文件",
defaultextension=f".{ext}",
filetypes=filetypes)
if filepath:
self.output_path.set(filepath)
self.log(f"选择输出文件：{filepath}")
def generate_output_filename(self):
"""生成输出文件名"""
input_path = self.input_path.get()
if not input_path:
return
input_dir = os.path.dirname(input_path)
input_name = os.path.splitext(os.path.basename(input_path))[0]
ext = self.format_var.get()
if self.timestamp_var.get():
# 生成带时间戳的文件名
now = datetime.now()
timestamp = now.strftime("%Y%m%d_%H%M%S")
base_filename = f"{input_name}_converted_{timestamp}.{ext}"
else:
# 普通文件名
base_filename = f"{input_name}_converted.{ext}"
output_file = os.path.join(input_dir, base_filename)
self.output_path.set(output_file)
self.log(f"自动生成输出文件名：{base_filename}")
def preview_filename(self):
"""预览文件名生成效果"""
input_path = self.input_path.get()
if not input_path:
messagebox.showinfo("预览", "请先选择输入文件")
return
input_name = os.path.splitext(os.path.basename(input_path))[0]
ext = self.format_var.get()
if self.timestamp_var.get():
# 使用当前时间生成示例
now = datetime.now()
timestamp = now.strftime("%Y%m%d_%H%M%S")
example_filename = f"{input_name}_converted_{timestamp}.{ext}"
message = f"启用时间戳后的文件名示例:\n\n{example_filename}\n\n格式说明:\n• 输入文件名：{input_name}\n• 时间戳：{timestamp}\n• 格式：{ext}"
else:
# 普通文件名
example_filename = f"{input_name}_converted.{ext}"
message = f"禁用时间戳后的文件名示例:\n\n{example_filename}\n\n注意：如果文件已存在会被覆盖！"
messagebox.showinfo("文件名预览", message)
def start_conversion(self):
"""开始转换"""
input_path = self.input_path.get().strip()
output_path = self.output_path.get().strip()
# 验证输入
if not input_path:
messagebox.showerror("错误", "请选择输入文件！")
return
if not os.path.exists(input_path):
messagebox.showerror("错误", "输入文件不存在！")
return
if not output_path:
messagebox.showerror("错误", "请选择或输入输出文件路径！")
return
# 更新 UI 状态
self.convert_btn.config(state='disabled')
self.clear_btn.config(state='disabled')
self.preview_btn.config(state='disabled')
self.progress.start()
self.status_var.set("正在转换...")
# 清空日志
self.clear_log()
# 设置转换器格式选择
self.converter.format_choice = self.format_var.get()
# 在后台线程中运行转换
thread = threading.Thread(
target=self.run_conversion,
args=(input_path, output_path),
daemon=True)
thread.start()
def run_conversion(self, input_path, output_path):
"""在后台线程中运行转换"""
try:
# 调用转换器
success, message, total_rows, filtered_rows, total_amount = self.converter.convert_file(
input_path, output_path, self.timestamp_var.get(), # 是否使用时间戳
self.log)
# 在主线程中更新 UI
self.root.after(0, self.conversion_finished, success, message, total_rows, filtered_rows, total_amount)
except Exception as e:
self.root.after(0, self.conversion_failed, str(e))
def conversion_finished(self, success, message, total_rows, filtered_rows, total_amount):
"""转换完成"""
# 停止进度条
self.progress.stop()
# 恢复按钮状态
self.convert_btn.config(state='normal')
self.clear_btn.config(state='normal')
self.preview_btn.config(state='normal')
if success:
self.status_var.set("转换完成")
# 更新统计信息
stats_text = f"转换统计:\n"
stats_text += f" 总行数：{total_rows}\n"
stats_text += f" 转换行数：{filtered_rows}\n"
if total_rows > 0:
stats_text += f" 转换率：{filtered_rows / total_rows * 100:.1f}%\n"
stats_text += f" 总金额：{total_amount:,.2f}\n"
stats_text += f" 输出文件：{os.path.basename(message)}"
self.update_stats(stats_text)
# 显示成功消息
self.log("=" * 50)
self.log("转换成功！")
self.log(f"输出文件：{message}")
self.log(f"处理统计：{filtered_rows}/{total_rows} 行")
self.log(f"总金额：{total_amount:,.2f}")
self.log("=" * 50)
# 询问是否打开文件
if messagebox.askyesno("转换完成", f"转换成功！\n\n" f"输出文件：{os.path.basename(message)}\n" f"总行数：{total_rows}\n" f"转换行数：{filtered_rows}\n" f"总金额：{total_amount:,.2f}\n\n" f"是否打开输出文件？"):
try:
if sys.platform == 'win32':
os.startfile(message)
elif sys.platform == 'darwin':
import subprocess
subprocess.call(['open', message])
else:
import subprocess
subprocess.call(['xdg-open', message])
except Exception as e:
self.log(f"无法打开文件：{e}")
else:
self.status_var.set("转换失败")
self.log("=" * 50)
self.log(f"转换失败：{message}")
self.log("=" * 50)
messagebox.showerror("转换失败", f"转换过程中出现错误：\n\n{message}")
def conversion_failed(self, error_msg):
"""转换失败"""
self.progress.stop()
self.convert_btn.config(state='normal')
self.clear_btn.config(state='normal')
self.preview_btn.config(state='normal')
self.status_var.set("转换失败")
self.log("=" * 50)
self.log(f"转换过程异常：{error_msg}")
self.log("=" * 50)
messagebox.showerror("转换异常", f"转换过程中出现异常：\n\n{error_msg}")
def run(self):
"""运行 GUI"""
self.root.mainloop()
''' def check_dependencies():
"""检查依赖库"""
missing_deps = []
# 检查 openpyxl
try:
import openpyxl
print("✓ openpyxl 已安装")
except ImportError:
missing_deps.append("openpyxl")
print("✗ openpyxl 未安装")
# 检查 xlwt
try:
import xlwt
print("✓ xlwt 已安装")
except ImportError:
missing_deps.append("xlwt")
print("✗ xlwt 未安装")
if missing_deps:
print(f"\n缺少依赖库：{', '.join(missing_deps)}")
print("请运行以下命令安装：")
print(f"pip install {' '.join(missing_deps)}")
# 询问是否自动安装
response = input("\n是否自动安装缺失的库？(y/n): ").lower().strip()
if response == 'y':
import subprocess
for dep in missing_deps:
print(f"正在安装 {dep}...")
subprocess.check_call([sys.executable, "-m", "pip", "install", dep])
print("安装完成！")
else:
print("请手动安装依赖库后重新运行程序。")
return False
return True
'''
def main():
"""主函数"""
print("=" * 50)
print("Excel 格式转换程序 - 带时间戳版本")
print("=" * 50)
print("功能:")
print(" • 读取.xlsx 文件（第 9 行标题，第 10 行开始数据）")
print(" • 筛选借贷标志为'贷'的记录")
print(" • 转换时间格式：2026-02-02 14:58:01 → 20260202 14:58:01")
print(" • 确保数值型数据正确保存（非文本型）")
print(" • 文件名自动添加日期时间后缀避免重复")
print(" • 格式：原文件名_converted_YYYYMMDD_HHMMSS.xls")
print("=" * 50)
''' # 检查依赖
if not check_dependencies():
return
'''
print("\n启动 GUI 界面...")
# 启动 GUI
app = ExcelConverterGUI()
app.run()
if __name__ == "__main__":
main()
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online