| name | excel-sheet-splitter |
| description | 将Excel工作簿按工作表拆分为独立的Excel文件，每个工作表生成一个单独的文件。适用场景：(1) 将多工作表Excel文件拆分为单独文件，(2) 提取特定工作表为独立文件，(3) 分发合并工作簿中的工作表，(4) 为单独处理或分发创建工作表副本。 |
Excel工作表拆分工具
任务目标
- 本Skill用于：将Excel工作簿(.xlsx, .xlsm)按工作表拆分为独立的Excel文件
- 能力包含：保留所有单元格值和公式、保持原始格式、维护列宽行高、保留合并单元格
- 触发条件：用户需要将多工作表Excel文件拆分为独立文件时
前置准备
- 依赖说明：scripts脚本所需的Python包
openpyxl>=3.0.0
- Python版本：3.7或更高版本
操作步骤
第一步：准备拆分
将需要拆分的Excel文件准备好，确保文件格式为.xlsx或.xlsm。
第二步：执行拆分
基本用法
使用默认设置拆分Excel文件（输出到相同目录）：
python scripts/split_excel_sheets.py input_file.xlsx
这将创建名为input_file_Sheet1.xlsx、input_file_Sheet2.xlsx等的文件。
高级选项
指定输出目录：
python scripts/split_excel_sheets.py input_file.xlsx -o ./output_folder
自定义文件名前缀：
python scripts/split_excel_sheets.py data.xlsx -p "2024年报表"
生成：2024年报表_Sheet1.xlsx、2024年报表_Sheet2.xlsx等。
JSON格式输出（用于程序化调用）：
python scripts/split_excel_sheets.py input_file.xlsx --json
返回包含文件路径和状态的结构化JSON数据。
第三步：查看结果
拆分完成后，在输出目录查看生成的Excel文件。每个工作表都会生成一个独立的Excel文件。
Python API调用
可以直接在Python代码中导入并使用函数：
from scripts.split_excel_sheets import split_excel_sheets
result = split_excel_sheets(
input_file='data.xlsx',
output_dir='./output',
prefix='自定义前缀'
)
print(f"状态: {result['status']}")
print(f"创建了 {len(result['files'])} 个文件")
输出格式说明
脚本返回一个字典，包含以下字段：
status: 状态码 ('success'成功, 'partial_success'部分成功, 'error'错误)message: 人类可读的摘要信息input_file: 原始文件路径output_directory: 文件创建位置files: 创建的文件路径列表errors: 错误信息列表（如有）total_sheets: 原始文件中的工作表数量successful: 成功创建的文件数量failed: 失败的工作表数量
文件命名规则
输出文件命名格式：{前缀}_{工作表名}.xlsx
- 默认前缀：输入文件名（不含扩展名）
- 工作表名会被清理（仅保留字母数字、空格、连字符、下划线）
- 文件系统不兼容的字符（如
/、\、*、?）会被移除
保留内容说明
拆分后的每个文件将保留：
- 所有单元格值和公式
- 原始格式（字体、颜色、边框、填充、数字格式）
- 列宽和行高
- 合并单元格
- 工作表结构
错误处理
脚本能处理常见问题：
- 文件不存在：报告文件未找到
- 无工作表：报告工作簿为空
- 工作表处理错误：继续处理其余工作表，逐个报告错误
- 工作表名中的非法字符：自动清理为有效文件名
退出代码：
局限性说明
- 外部引用公式：如果公式引用其他工作表的单元格，在独立文件中可能显示错误
- 工作表间依赖：引用其他工作表的图表或数据验证可能无法正常工作
- 宏代码：.xlsm文件的VBA代码会被保留，但引用其他工作表的宏可能失败
使用示例
示例1：拆分报表用于分发
功能：将月度报表按部门工作表拆分
执行方式：脚本执行
python scripts/split_excel_sheets.py monthly_report.xlsx -o ./team_reports -p "2024年1月"
输出：在team_reports目录生成以"2024年1月"为前缀的独立Excel文件
示例2：提取所有工作表用于单独处理
功能：将合并数据文件的每个工作表提取为独立文件
执行方式：脚本执行
python scripts/split_excel_sheets.py consolidated_data.xlsx
输出：每个工作表成为独立的Excel文件，可用于单独分析
示例3：程序化批量处理
功能：批量处理多个Excel文件
执行方式：Python代码
import glob
from scripts.split_excel_sheets import split_excel_sheets
for file in glob.glob('*.xlsx'):
result = split_excel_sheets(file, output_dir='./split_files')
if result['status'] != 'success':
print(f"{file}处理遇到问题: {result['message']}")
输出：所有Excel文件的工作表都被拆分到split_files目录
测试建议
在处理重要文件之前，建议使用样本工作簿进行测试：
python scripts/split_excel_sheets.py test_file.xlsx -o ./test_output
资源索引
注意事项
- 确保Excel文件路径正确，文件格式为.xlsx或.xlsm
- 拆分后的文件中，跨工作表引用的公式可能需要手动调整
- 工作表名中的特殊字符会被自动清理为文件系统兼容的字符
- 建议先用测试文件验证功能，再处理重要数据
