📗 Excel / XLSX - 创建、检查与编辑 Excel 工作簿及 XLSX 文件，保持公式、日期、格式等可靠性

何时使用

当主要产出是 Microsoft Excel 工作簿或电子表格文件，尤其在以下情形下需要关注公式、日期、格式、合并单元格、工作簿结构或跨平台行为时使用本技能。

核心规则

1. 按工作类型选择工作流，而不是按习惯

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

2. 日期是带有历史怪癖的序列号

• Excel 将日期存储为序列号，而非真实的日期对象。
• 1900 日期系统包含错误的闰年 2 月 29 日，一些工作簿使用 1904 系统。
• 时间是“一天的小数”，因此格式化和转换同样重要。
• 即使数值正确，如果数字格式仍然向用户展示错误的内容，也视为日期不正确。

3. 当工作簿需保持实时计算时，让 Excel 完成计算

• 将公式写入单元格，而不是将 Python 计算得到的结果硬编码进单元格。
• 使用对假设单元格的引用，而不是在公式中写死数值。
• 缓存的公式值可能已经过时，编辑后切勿盲目信任它们。
• 在交付前检查复制的公式是否出现错误的范围、错误的工作表以及隐蔽的越界偏移。
• 绝对引用和相对引用是逻辑的一部分，复制公式时即使仍能“工作”，也可能出现错误。
• 在将公式填充至整块之前，先在少量具有代表性的单元格上测试新公式。
• 在交付依赖公式的文件前，务必核实分母、命名范围以及前置单元格。
• 工作簿交付时应零公式错误，不能留下已知的 #REF!、#DIV/0!、#VALUE!、#NAME? 或循环引用等问题让用户自行修复。
• 对于模型式工作，在注释或相邻的备注中记录不明显的硬编码、假设或来源输入。

4. 在 Excel 损坏数据前保护数据类型

• 长标识符、手机号、邮编以及带前导零的值通常应存为文本。
• Excel 会在超过 15 位数字后静默截断精度。
• 混合的文字‑数字列需要在读取和写入时显式处理。
• 科学计数法、自动解析的日期以及被剥离的前导零都是常见的腐化，而非仅是外观问题。

5. 在更改内容前保留工作簿结构

• 现有模板会覆盖通用的样式建议。
• 合并区域只有左上角单元格保存数值。
• 隐藏行、隐藏列、命名范围以及外部引用仍可能影响公式和输出。
• 共享字符串、已定义名称以及工作表层面的约定即便在可见单元格看起来很简单也可能重要。
• 为新填充的单元格匹配已有样式，而不是悄悄引入全新的视觉体系。
• 如果工作簿是模板，除非任务明确要求，否则应保留工作表顺序、列宽、冻结窗格、筛选、打印设置、数据验证以及视觉约定。
• 条件格式、筛选、打印区域和数据验证往往承载业务含义，即使用户仅提到数字。
• 若文件没有现成的样式指南且属于模型文件，应让可编辑的输入在视觉上与公式区分开，但不要为了统一的通用样式而覆盖已建立的模板。

6. 在交付前重新计算并复核

• 仅有公式字符串不足以满足接收方需要即时数值的场景。
• openpyxl 能保留公式但不会计算它们。
• 必须确认工作簿中不再残留 #REF!、#DIV/0!、#VALUE!、#NAME? 或循环引用等错误。
• 若布局重要，交付前应渲染或目视检查工作簿。
• 注意读取模式：仅为数值打开工作簿后保存会把公式平坦化为静态值。
• 如果假设或硬编码的覆盖必须保留，请确保其足够显眼，以便后续编辑者审计。

7. 根据文件大小扩展工作流

• 大型工作簿容易因内存突增、填充空行或整表读取缓慢而失败。
• 当文件大到一次性加载变得脆弱时，使用流式或分块读取。
• 大文件工作流还需要更窄的读取范围、显式的 dtype 以及针对特定工作表的操作，以避免意外破坏。

常见陷阱

• 读取时的类型推断可能把数字当成文本或把 ID 转成受损的数值。
• 各工具的列索引方式不同，生成公式时常出现 off‑by‑one 错误。
• 单元格中的换行符需要换行包装才能正确显示。
• 外部引用在源文件移动后容易失效。
• 旧 Excel 工作流中的密码保护并非真正的安全手段。
• .xlsm 可能包含宏，.xls 仍是更严格的老旧格式。
• 大文件可能需要流式读取或更细致的内存管理。
• Google Sheets 与 LibreOffice 可能对日期、公式或样式的解释与 Excel 不同。
• 动态数组或更高版本 Excel 函数如 FILTER、XLOOKUP、SORT、SEQUENCE 在旧版查看器中可能失效或降级。
• 工作簿看似正常却仍携带来自上一次重新计算的陈旧缓存值。
• 保存错误的工作簿视图会把公式替换为缓存值，悄然破坏活模型。
• 复制公式而未检查相对引用会把一个错误范围推向整块。
• 隐藏工作表、命名范围、验证规则以及合并区域常常保留业务逻辑，肉眼快速浏览时不可见。
• 工作簿看似数值正确，却因筛选、条件格式、打印设置或数据验证被剥离而失败。
• 工作簿数值正确但视觉上仍会出现问题，例如换行文本、被截断的标签或从未审查过的窄列。

相关技能

如果用户确认，可使用以下命令安装相关技能：

• csv — 纯文本表格的导入与导出工作流。
• data — 在生成电子表格之前的通用数据处理模式。
• data-analysis — 可提供输出至工作簿的高级分析。

反馈

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