Excel 批量填充工具

功能

• 选择数据源 Excel、模板 Excel 和输出目录。
• 支持选择输出方式：每条记录一个文件，或全部记录合并为一个工作簿（多工作表）。
• 在 UI 中自定义字段映射（源列/规则 -> 模板单元格）。
• 支持在 UI 中动态增加/删除字段映射行。
• 支持一键恢复默认映射，并可删除选中的映射行。
• 自动保存 UI 设置到 ui_settings.json（路径与映射下次启动自动恢复）。
• 后台线程批量生成文件，界面保持响应。
• 统一采用 auto_renamer 同款目录结构与 GUI 样式。
• 支持 Nuitka 打包为 Windows 独立可执行程序。

数据源格式

默认从第 2 行开始读取数据，A-D 列含义如下：

列	字段
A	物料号
B	物料名称
C	配送地点
D	自编号

字段映射（可在 UI 配置）

默认映射如下（可修改）：

模板单元格	源列/规则
B1	A
B2	B
B3	@EMPTY
B4	C
B5	D
B6	@TODAY

规则说明：

• A-Z：读取源表对应列（从第 2 行开始）。
• @EMPTY：写入空值。
• @TODAY：写入当天日期（YYYY-MM-DD）。

映射操作：

• + 添加映射行：增加一条新映射。
• 选中行左侧单选按钮后，点击 - 删除选中行 删除对应映射。
• 恢复默认映射：一键恢复默认 6 条映射。

输出文件名默认格式：表单_<D列值>_<序号>.xlsx（非法文件名字符会自动替换）。

UI 设置自动保存

程序会在项目根目录生成 ui_settings.json，自动保存以下内容：

• 数据源路径、模板路径、输出目录。
• 输出模式和单文件名。
• 字段映射配置（目标单元格与源规则）。

常见映射示例

示例 1：把源表 F 列写入模板 C8

• 在映射区把某一行设置为：模板单元格 C8，源列/规则 F。

示例 2：固定留空“备注”单元格

• 设置为：模板单元格 D10，源列/规则 @EMPTY。

示例 3：在模板中写入当天日期

• 设置为：模板单元格 E3，源列/规则 @TODAY。

示例 4：一行配置多个字段

• B1 <- A（物料号）
• B2 <- B（物料名称）
• C8 <- F（扩展字段）
• E3 <- @TODAY（日期）

映射排错指南

1. 结果为空值

• 先检查源列是否有数据（例如选择了 F，但 F 列实际为空）。
• 注意程序从第 2 行开始读取，首行通常是表头。

2. 提示“无效模板单元格”

• 模板单元格必须是 Excel 格式，如 B1、C8、AA12。
• 不支持 1B、B0、空字符串等格式。

3. 同一个模板单元格被重复配置

• 例如同时配置 B2 <- A 和 B2 <- C，后面的配置会覆盖前面的值。
• 建议每个目标单元格只配置一次。

4. 生成文件名不符合预期

• 文件名来自源表 D 列（自编号）和序号。
• 如果 D 列为空，会回退为序号；非法字符会自动替换为 _。

5. 重新打开程序后配置没恢复

• 确认项目根目录存在 ui_settings.json。
• 检查该文件是否可写、是否被其他程序占用或损坏（非合法 JSON）。