Zion导入卡顿的根源在于未启用批量写入，需开启「高性能批量导入」开关并重启服务；模板须用系统导出、严格匹配中文字段名、清除空行与格式；推荐CLI命令行导入（每500行事务分片）或数据库直写（跳过校验）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想在函子Zion里一次导入几千条商品、客户或库存记录，系统响应变慢、进度条卡住、甚至前端无响应，不是小概率事件，而是未做前置准备时的典型表现——根源不在“几千条”本身，而在于导入路径是否绕开了单条事务刷盘、字段校验是否在内存中完成、以及目标表索引是否在导入时持续维护。
确认Zion当前导入模式是否启用批量写入
进入Zion后台 → 系统设置 → 数据管理 → 导入配置，检查「启用高性能批量导入」开关是否为开启状态。该选项默认关闭，【关闭状态下所有Excel导入均走单条INSERT + 逐行校验路径，500条以上即明显卡顿】。若为关闭，请先保存启用并重启Zion服务进程（非仅刷新页面），否则后续操作全部无效。
准备Excel模板前必须做的三件事
第一步：用Zion导出功能拉一份空模板（路径：商品管理 → 批量导入 → 下载模板），不要自行新建Excel；
第二步：核对模板首行字段名与Zion字段映射表完全一致，尤其注意“条码”字段不能写作“barcode”或“bar_code”，Zion严格匹配中文字段名；
第三步：删除模板中所有示例数据行，只保留标题行，然后粘贴你的几千条数据——【切勿保留任何空行、合并单元格、公式或条件格式，否则Zion解析器会在第37行或第192行静默失败且不报错】。
执行导入时的关键控制点
方法一：Web端直接上传（适合≤2000条）
选择文件 → 勾选「跳过重复编码检测」→ 点击导入 → 观察右上角进度提示条。若10秒内无反应，立即关闭标签页重试，不要等待。
方法二：CLI命令行导入（推荐≥1500条）
在Zion安装目录下运行：./zloader --file ./goods_batch.xlsx --table product --mode bulk --skip-dup。此方式绕过Web层HTTP超时限制，且自动启用事务分片（每500行为一个事务块）。
方法三：数据库直写（仅限DBA操作）
将清洗后的CSV放入Zion服务器/data/import/目录 → 登录Zion内置PostgreSQL执行：COPY product FROM '/data/import/goods_batch.csv' WITH (FORMAT CSV, HEADER true);。此路径最快，但【跳过所有业务规则校验，如分类是否存在、单位是否合法，错误数据将直接写入脏表】。
