Excel / XLSX

核心用途

本 Skill 是一份关于 Microsoft Excel 工作簿处理的最佳实践文档，而非可执行工具。它系统性地指导用户如何在 Python 生态中正确处理 .xlsx、.xlsm、.xls 等格式，特别强调公式保真、日期系统、格式 preservation 和工作簿结构完整性。

显著优点

1. 工作流清晰分层：明确区分 pandas（分析/CSV 任务）与 openpyxl（公式/样式/结构任务）的适用场景，避免工具误用
2. 技术细节深入：涵盖 Excel 日期系统（1900/1904）、15位精度截断、缓存值失效等真实坑点
3. 模型保真意识：强调保持工作簿"活性"——写入公式而非硬编码结果，验证引用完整性，避免 #REF! 等残留错误
4. 模板尊重原则：要求保留现有模板的视觉系统、冻结窗格、打印设置、数据验证等隐性业务逻辑

潜在局限

• 纯文档无代码：仅提供指导原则，不包含可运行的封装函数或 API
• 需配合工具使用：实际执行仍需用户自行组合 openpyxl、pandas 等库
• 高级功能覆盖有限：动态数组函数（FILTER、XLOOKUP 等）仅提及兼容性风险，未展开处理策略
• 性能优化较简略：大文件流式处理仅点到为止，缺乏完整实现示例

适合人群

• 需要用 Python 生成或修改 Excel 报表的数据工程师
• 维护财务模型、预算模板等"活工作簿"的分析师
• 追求跨平台（Windows/Mac/云）Excel 文件兼容性的开发者

常规风险提示

• 误读 "cached values" 可能导致发送含过期数据的工作簿
• 公式复制时未检查相对/绝对引用会造成隐蔽计算错误
• .xlsm 宏文件存在潜在安全风险，但本 Skill 本身不含宏代码
• 新旧 Excel 版本函数兼容性差异可能导致接收方无法正常显示

核心用法

本 Skill 是一份针对 Microsoft Excel/XLSX 文件处理的纯文档型最佳实践指南，不提供可执行代码，而是系统化阐述处理电子表格时的关键决策框架与操作规范。核心使用场景包括：

• 格式与结构敏感任务：当公式、样式、合并单元格、工作簿结构或跨平台兼容性成为关键需求时，优先使用 openpyxl 而非 pandas
• 数据分析与转换：对于纯数据重塑、CSV 类任务，使用 pandas 更为高效
• 模板继承与交付：处理现有模板时需保留冻结窗格、打印设置、数据验证等隐式业务逻辑

关键操作规范

1. 日期系统认知：Excel 以序列号存储日期（1900/1904 系统），存在虚假闰年 bug；时间以分数日表示，格式与数值转换同等重要
2. 公式优先策略：在需要保持工作簿"活性"的场景中，将公式写入单元格而非硬编码 Python 计算结果；警惕缓存值失效、相对引用漂移、跨表引用断裂
3. 数据类型防护：长标识符、电话、邮编应存为文本；Excel 静默截断 15 位以上精度；混合列需显式处理
4. 结构完整性：合并单元格仅左上存储值；隐藏行列、命名范围、外部引用可能承载不可见业务逻辑
5. 交付前验证：使用 openpyxl 保存后需重新计算公式；检查 #REF!、#DIV/0! 等错误；视觉审查布局与换行

显著优点

• 零攻击面：纯 Markdown 文档，无可执行代码、无外部依赖、无网络调用，供应链风险为零
• 决策框架清晰：明确区分 pandas 与 openpyxl 的适用边界，避免工具误用导致的格式丢失
• 工程化细节完备：涵盖日期序列号、1900 bug、公式引用类型、缓存值失效等生产级陷阱
• 模型治理意识：强调假设文档化、输入输出视觉区分、审计可追溯性等企业级建模规范

局限性与注意事项

• 无自动化实现：仅为指南文档，具体代码实现需用户自行编写或借助其他工具
• T3 来源可信度：维护者为个人开发者账号，无企业背书，功能正确性依赖社区验证
• 版本兼容边界：动态数组函数（FILTER、XLOOKUP 等）在旧版查看器可能降级或失败
• 性能建议有限：虽提及流式读取概念，但未提供具体实现代码或内存阈值参考

适合人群

• 数据工程师/分析师：需要交付可交互、公式驱动的 Excel 模型而非静态数据导出
• 财务建模人员：处理包含复杂公式引用、跨表计算、假设敏感性分析的预算或估值模型
• 企业系统集成者：在 Python 自动化与 Excel 用户端之间建立可靠的数据交换管道
• 审计与合规岗位：需要理解 Excel 文件结构以进行模型审查、差异追踪或版本控制

常规风险

• 公式漂移风险：复制公式时未校验相对/绝对引用可能导致整块区域计算错误
• 静默数据损坏：类型推断将 ID 转为数字、科学计数法截断、前导零剥离等问题常被忽视
• 跨平台解释差异：Google Sheets、LibreOffice 对日期、公式、样式的解析可能与 Excel 不一致
• 活性丢失：误操作可将公式扁平化为静态值，破坏模型的可审计性与动态更新能力