Excel / XLSX

何时使用

当主要交付物是 Microsoft Excel 工作簿或电子表格文件时使用，特别是当涉及公式、日期、格式设置、合并单元格、工作簿结构或跨平台行为时。

核心规则

1. 根据任务选择工作流程，而非习惯

• 使用pandas进行分析、数据重塑和类似 CSV 处理的任务。
• 使用openpyxl当涉及公式、样式、工作表、批注、合并单元格或需要保留工作簿特性时。
• 将 CSV 视为纯数据交换格式，而非功能完备的 Excel 格式。
• 读取数值、保留活动工作簿以及从头构建模型是不同的电子表格任务。

2. 日期是具有历史遗留问题的序列号

• Excel 将日期存储为序列号，而非真实的日期对象。
• 1900 日期系统包含错误的闰日漏洞，且某些工作簿使用 1904 日期系统。
• 时间是小数形式的天数数据，因此格式设置和转换都很重要。
• 如果数字格式仍向用户显示错误内容，仅日期正确是不够的。

3. 当工作簿需要保持活动状态时，将计算保留在 Excel 中

• 将公式写入单元格，而非从 Python 硬编码派生结果。
• 在公式中引用假设单元格，而非使用硬编码的魔数。
• 缓存的公式值可能已过时，因此在编辑后切勿盲目信任它们。
• 交付前，检查复制的公式是否存在错误范围、错误工作表以及不易察觉的差一错误偏移。
• 绝对引用和相对引用是逻辑的一部分，因此即使复制的公式仍能"运行"，也可能存在错误。
• 在将新公式填充至整个区域前，先在几个代表性单元格上进行测试。
• 在交付依赖于分母、命名区域和引用单元格的公式前，请先验证它们。
• 工作簿交付时应确保零公式错误，而非包含已知的#REF!#DIV/0!#VALUE!#NAME?或留下循环引用错误让用户自行修复。对于模型类工作，请在注释或附近备注中记录不明显的硬编码、假设或数据来源。4. 在Excel篡改前保护数据类型长标识符、电话号码、邮政编码以及前导零数值通常应存储为文本格式。
• Excel会静默截断超过15位的数字精度。

混合文本-数字列在读取和写入时需要显式处理。

• 科学计数法、自动解析的日期和被移除的前导零是常见的数据损坏问题，而非表面格式问题。
• 5. 修改内容前先保留工作簿结构
• 现有模板优先于通用样式建议。
• 合并单元格区域中仅左上角单元格存储数值。

隐藏行、隐藏列、命名区域和外部引用仍可能影响公式与输出结果。

• 共享字符串、定义名称和工作表级约定即使可见单元格看似简单也可能很重要。
• 新填充的单元格应匹配现有样式，而非静默引入新的视觉体系。
• 若工作簿是模板，除非任务明确要求变更，否则应保留工作表顺序、列宽、冻结窗格、筛选器、打印设置、数据验证和视觉惯例。
• 条件格式、筛选器、打印区域和数据验证通常承载业务含义，即使用户仅提及数字。
• 若没有现有样式指南且文件为模型，应保持可编辑输入项与公式在视觉上可区分，但绝不要覆盖既定模板来强制推行通用内部样式。
• 6. 交付前重新计算并复核
• 若接收方需要当前数值，仅保留公式字符串是不够的。
• openpyxl

库能保留公式但不会计算其值。

• 需确认不存在
• #REF!preserves formulas but does not calculate them.
• Verify no#REF!#DIV/0!#VALUE!#NAME?，或循环引用导致的错误仍然存在。如果布局很重要，在宣告工作簿完成之前，请进行渲染或视觉检查。注意读取模式：仅以读取数值的方式打开工作簿然后保存，可能会将公式转换为静态值。如果必须保留假设或硬编码的覆盖值，请使其足够明显，以便下一位编辑者能够审核工作簿。
• 7. 根据文件大小调整工作流程
• 大型工作簿可能会因一些常见原因而失败：内存峰值、填充的空行以及缓慢的全表读取。
• 当文件大到一次性加载所有内容变得不稳定时，请使用流式读取或分块读取。

处理大型文件的工作流程还需要更精确的读取、明确的数据类型以及有针对性的工作表操作，以避免意外损坏。

• 常见陷阱
• 读取时的类型推断可能导致数字被识别为文本，或将ID转换为损坏的数值。
• 不同工具的列索引方式不同，因此在生成的公式中，差一错误很常见。

单元格中的换行符需要进行包装才能正确显示。

• 当源文件移动时，外部引用很容易失效。
• 旧版Excel工作流程中的密码保护并非真正的安全措施。
• .xlsm
• 文件可能包含宏，而
• .xls
• 仍然是一种更紧凑的旧版格式。大型文件可能需要流式读取或更谨慎的内存处理。Google Sheets 和 LibreOffice 对日期、公式或样式的解释可能与 Excel 不同。动态数组或较新的 Excel 函数，如
• FILTER
• Google Sheets and LibreOffice can reinterpret dates, formulas, or styling differently from Excel.
• Dynamic array or newer Excel functions likeFILTER,XLOOKUP、SORT或SEQUENCE等功能在较旧的查看器中可能失效或性能下降。
• 工作簿看起来可能一切正常，但仍可能携带先前重新计算留下的过时缓存值。
• 保存错误的工作簿视图可能会用缓存值替换公式，从而无声地破坏一个活跃的模型。
• 复制公式时不检查相对引用，可能会将一个错误范围扩散到整个区域。
• 隐藏工作表、命名区域、数据验证和合并区域通常承载着在快速浏览中不可见的业务逻辑。
• 工作簿可能在数值上看起来正确，但仍会失败，因为筛选器、条件格式、打印设置或数据验证已被移除。
• 工作簿可能在数值上正确，但视觉上仍会失败，因为自动换行、被截断的标签或过窄的列从未被检查过。

相关技能

使用以下命令安装：clawhub install <slug>（如果用户确认）：

• csv——纯文本表格导入和导出工作流。
• data——电子表格输出前的一般数据处理模式。
• data-analysis——可生成工作簿交付成果的更高级别分析。

反馈

• 如果觉得有用：clawhub star excel-xlsx
• 保持更新：clawhub sync