二次元人物桶创建或导入失败，通常不是人物资料本身出了问题，而是名称冲突、必填字段缺失、导入映射错位，或图片等附件没有一并处理。排查时先确认失败发生在哪一步，再依次检查桶设置、数据格式、重复规则和显示状态；确认原因后再重试，能避免空桶、重复人物和资料错位。
先按现象定位问题
| 表现 | 常见原因 | 优先检查 |
|---|---|---|
| 创建后没有反应 | 桶名称为空、名称含不支持的字符，或必填项未完成 | 名称、描述及带标记的必填字段 |
| 提示创建成功，却找不到桶 | 保存到了其他分类，或当前列表仍显示旧内容 | 所属分类、筛选条件与列表刷新状态 |
| 导入中断或提示格式错误 | 字段标题不匹配、分隔符错乱，或某行缺少关键值 | 首行字段、出错行和文本编码 |
| 导入后人物资料串栏 | 列顺序与字段映射不一致，或备注中含有额外分隔符 | 姓名、别名、标签等列的对应关系 |
| 人物重复、头像不显示 | 重复判断规则不同，或图片未随数据导入 | 姓名与别名、图片路径及附件状态 |
按顺序排查，先保住已有资料
- 确认失败环节。分清问题发生在新建桶、保存桶设置、导入文件，还是导入后的列表显示。记录当时使用的桶名、导入文件和出现的提示，不要连续点击创建或重复导入；否则一次保存延迟可能变成多个同名桶或重复人物。
- 检查桶名称和必填设置。把名称暂时改成简短、易识别的文字，去掉首尾空格、换行和连续特殊符号，再检查是否遗漏分类、可见范围等必填项。创建后仍找不到时，先清除列表筛选，查看是否保存到了另一个分类；不要立刻再次新建。
- 检查人物数据的字段结构。导入前确认每条记录都有可识别的人物名称，并把别名、作品、身份、标签、简介和头像分别放入对应字段。字段名不一致时，先按导入工具提供的字段映射逐项对应，不要仅凭列的位置猜测。若提示某一行错误，优先检查该行是否少了名称、引号未闭合，或把多段资料挤进同一列。
- 检查文件格式与文本细节。查看文件是否使用当前导入功能支持的格式，分隔符是否统一，文本编码是否造成中文乱码。人物简介里含逗号、换行或引号时，按文件格式正确包裹文本，避免后续字段整体偏移。先用少量人物记录测试，确认列没有串位后，再处理完整清单。
- 区分重复人物与同名角色。同一个人物可能有多个别名，也可能不同作品中存在同名角色。导入前先统一命名方式，例如在姓名字段保留常用称呼，在作品或备注字段记录出处；再查看工具按姓名、别名还是唯一标识判断重复。发现重复时先合并或跳过对应记录，不要直接覆盖整桶已有资料。
- 单独处理头像和附件。人物文字导入成功、图片却缺失，通常是图片没有随文件一起导入，或记录中的图片名称与实际附件不一致。核对头像文件名和人物记录的对应关系，再补充图片；不要因头像显示为空就重新导入整份人物表。头像恢复后抽查数条记录，确认图片没有挂到其他角色名下。
创建与导入的恢复顺序
原因排除后，再按“建桶、试导入、核对、批量补齐”的顺序恢复。新建时先填写桶名和必要的分类设置，保存后确认桶出现在正确列表中；若桶已存在，直接进入该桶，不要重复创建。导入时先选取少量记录，完成字段映射后检查人物姓名、作品、标签和简介是否各归其位，再继续导入剩余数据。
导入成功后，不要只看提示文字。打开桶抽查首条、中间一条和末条人物记录，确认姓名完整、标签未粘连、简介没有截断；再检查重复项数量和头像显示情况。若只有少数记录出错，优先修正这些记录并单独补录，保留其余成功数据。若整批字段错位，则停止后续导入，撤回或清理本批错误记录，修正映射后从测试数据重新开始。
恢复完成的判断标准
当桶能在预期分类中打开，新增记录可以正常保存，导入人物的字段对应正确，重复项没有无意增加，头像也能与人物匹配，故障才算排除。创建失败从名称和必填设置查起；导入失败从格式、字段映射查起；导入后显示异常则回到分类筛选、重复规则和附件对应关系。按这个顺序逐项缩小范围，通常能保留已有角色资料，并避免把局部错误扩大成整桶重建。
