CSV 字段怎么映射到平台模板？列改名、默认值与安全导出指南

供应商把商品表发成 sku,name,unit_price，ERP 导出字段叫 item_no,title,cost，平台上传模板却要求 SKU,Title,Price。手动复制一两次看似很快，长期重复操作却容易错列、漏列，还难以复现上一次采用的规则。

可以使用 CSV 列映射与模板转换工具 在浏览器本地读取源 CSV 和目标表头，为每个目标字段选择来源、常量、空值回退及前后缀，再下载顺序正确的新 CSV。映射配置可以单独保存为 JSON，不包含原始业务数据。

为什么应从目标模板开始，而不是从源表开始

真正决定导入是否成功的是目标系统要求的字段名、顺序和必填规则。先打开平台最新空模板，只读取第一行表头，再逐列回答“这个目标字段从哪里来”。这样能发现源数据缺少的必填项，而不是把现有列全部导出后再碰运气。

自动匹配只适合大小写、空格、下划线或连字符不同的同名字段。例如 unit_price 与 Unit Price 可以安全归一化匹配；name 与 Title 虽然可能语义相近，却不应由通用工具擅自决定。业务字段必须由了解数据的人确认。

模板版本也要记录。平台增加新字段、删除旧字段或改变枚举值后，旧映射配置可能仍能生成 CSV，但导入结果不再正确。建议把模板版本、映射配置和处理日期放在同一个工作目录中。

来源字段、常量和空值回退分别怎么用

来源字段用于逐行复制源表某一列，例如 SKU ← sku。常量列用于每一行都相同的值，例如品牌、币种或默认站点。空值回退只在来源单元格为空时使用，例如缺少 currency 时填 USD。

前缀和后缀适合明确的格式拼接，例如给内部编号加 SUP-，或给尺寸值加单位。它们不是通用文本模板：如果需要跨多个字段组合标题，应先在源表生成组合列，或者使用专门的模板合并流程。

需要特别区分“空值”和数字零。库存 0 是有效值，不应触发回退；真正空单元格才使用默认值。日期、价格和布尔值最好在源系统统一格式，列映射工具不会猜测 07/08/2026 是 7 月 8 日还是 8 月 7 日。

CSV 引号、换行与重复表头为什么重要

RFC 4180 描述了常见 CSV 的记录、字段和双引号规则。商品标题或地址里可能包含逗号、双引号和换行；可靠解析器应把引号内换行保留在同一个单元格，而不是按肉眼看到的每一行切割。

重复目标表头会让后续系统难以确定写入哪一列，因此工具会阻止导出。空目标字段、尚未选择的来源以及源表不存在的字段也会作为致命映射问题显示。源文件中列数不一致、未闭合引号等解析提示同样不能忽略。

CSV 没有统一的数据类型声明。价格 12.40、代码 00123 和日期都可能被表格软件自动转换。正式上传前应使用文本导入模式打开一次，确认前导零、长编号和小数位没有被 Excel 等软件改写。

为什么导出时要防止 CSV 公式注入

如果单元格以 =、+、-、@ 开头，部分表格软件可能把它当作公式执行。外部供应商名称、评论或地址本应只是文本，却可能触发公式或外部链接。工具默认给这类值添加前导单引号，让常见表格软件按文本处理。

关闭保护前要确认目标平台确实要求原始前导符号，并且数据来源可信。不要只因为导入界面显示单引号就全局关闭保护；更稳妥的方法是先查目标系统如何处理文本前缀，再使用少量样本测试。

一套可重复的模板转换流程

1. 下载目标平台最新空模板，保留原文件和版本日期。
2. 用 5 至 20 行包含空值、中文、逗号、长编号和异常字符的源数据做样本。
3. 导入目标表头，自动匹配后逐列人工确认业务含义。
4. 为缺失必填字段选择常量或补充上游数据，不要用无意义占位符蒙混。
5. 抽查首行、中间行和末行，确认字段顺序、价格、库存和状态一致。
6. 导出并用目标平台的测试导入或预检功能验证。
7. 保存映射配置；下次使用时仍要与新模板比较字段变化。

浏览器工具适合两万行以内、规则明确的一次性转换。涉及多表关联、条件分支、字段计算、数十万行或需要审计日志时，应使用 ETL、数据库或版本化脚本，并给转换规则增加自动化测试。