测试用例导入导出方法：Excel、CSV、JSON 三种实操方案

小王刚接手一个老项目，测试用例散在三个人的 Excel 表里，还有十几条在禅道里没同步。上线前两天，他得把所有用例统一整理进 TestLink——这时候，光靠手动复制粘贴，一天都搞不完。

为什么非得会导入导出？

不是为了炫技，是真省时间。比如：外包团队交来一批 Excel 格式用例，你得快速塞进公司用的 Tapd；或者测试组长临时要一份当前版本所有用例的快照发给产品复核；再比如，换用新工具前，得把旧系统里的数据完整搬出来——这些场景，每天都在发生。

Excel 导入：最常用，也最容易翻车

多数工具（如 Xray、Zephyr、TestLink）都支持 Excel 导入，但别直接拖文件就点“确定”。先确认表头是否匹配：一般至少要有 用例编号、标题、前置条件、步骤、预期结果、优先级 这几列。特别注意：步骤 和 预期结果 如果含换行，Excel 里得用 Alt+Enter 换行，不能敲回车，否则导入后全挤成一行。

示例 Excel 表结构（.xlsx）：

用例编号,标题,前置条件,步骤,预期结果,优先级
TC-001,登录页输入空密码,已打开登录页,"1. 点击登录按钮\n2. 不输入任何内容","提示【密码不能为空】",P1
TC-002,正确账号密码登录,已打开登录页,"1. 输入账号 testuser\n2. 输入密码 123456\n3. 点击登录","跳转至首页",P1

CSV 导出：跨平台兼容性最强

想把 Jira 里的用例导出来给没装插件的同事看？CSV 是首选。用浏览器打开 Jira 的测试用例列表页 → 点右上角「导出」→ 选「CSV（所有字段）」。导出的文件用记事本打开可能乱码，建议用 WPS 或 Excel 以 UTF-8 编码打开。如果发现中文变成方块或问号，说明编码错了，重新用 Excel「数据 → 自获取外部数据 → 从文本」，手动选 UTF-8 即可。

JSON 批量操作：适合有脚本基础的人

当你需要自动化处理上百个用例时，JSON + Python 就派上用场了。比如从 Postman 导出的 collection.json，稍加改造就能转成标准测试用例格式：

{
  "testcase_id": "API-007",
  "title": "获取用户信息接口返回状态码校验",
  "method": "GET",
  "url": "https://api.example.com/v1/user/123",
  "expected_status": 200,
  "check_point": "响应体包含 name 字段且不为空"
}

用几行 Python 就能批量生成 CSV 或插入到数据库，比点鼠标快十倍。

避坑提醒

• 导入失败别急着重试，先看错误日志——90% 是某一行的「预期结果」里多了个半角逗号，导致 CSV 列错位；
• TestLink 导入 Excel 前必须删掉空行和合并单元格，否则报“解析失败”；
• 禅道导出的 Excel 默认带格式（颜色、边框），导入其他工具前建议另存为「Excel 工作簿（*.xlsx）」，不选「Excel 97-2003」；
• 所有用例导出后，务必抽样检查 3～5 条，重点看步骤换行、特殊符号（如 &、<）、中文标点是否完整保留。

工具只是手，方法才是活。摸清自己手头那套系统的导入规则，比背一百条理论都管用。