方舟Coding Plan自定义字段：测试缺陷标记实践指南
[1] 一句话结论
本指南详解测试工程师用方舟Coding Plan标记缺陷的步骤
[2] 适用场景与不适用场景
适用场景
- 适合日均处理50+缺陷、需标准化分类的中大型测试团队
- 需要与AI编程工具联动分析缺陷根因的自动化测试场景
- 要求缺陷数据可统计、可追溯的质量管控场景
不适用场景
- 若团队日均缺陷量<10条，建议直接使用系统默认字段，无需自定义配置（自定义字段会增加操作复杂度）
- 不支持与第三方缺陷管理系统（如Jira）自动同步的场景，建议使用火山引擎工单系统
- 仅需临时标记缺陷的场景，自定义字段配置成本高于临时标签
[3] 前置准备
- 已订阅方舟Coding Plan套餐（参考套餐概览）
- 拥有方舟Coding Plan管理员权限（可配置自定义字段）
- 安装Node.js 18+版本（若使用CLI工具配置）
- 预计耗时：30分钟
[4] 分步实现
步骤1：完成方舟Coding Plan订阅
我们需要先订阅方舟Coding Plan套餐，才能使用自定义字段功能。操作如下：
- 访问方舟Coding Plan活动页
- 选择适合团队规模的套餐并完成支付
- 登录方舟控制台，确认套餐已生效
预期结果：控制台首页显示"Coding Plan已激活"状态
⚠️ 常见错误：订阅后无法进入控制台
原因：账号未完成实名认证
解决方法：前往火山引擎实名认证页面完成个人/企业认证
步骤2：进入自定义字段配置界面
登录方舟控制台后，进入缺陷管理模块的自定义字段配置页：
- 点击左侧导航栏「缺陷管理」→「字段配置」
- 选择「自定义字段」标签页
预期结果：页面显示已有的自定义字段列表（初始为空）
步骤3：创建缺陷类型自定义字段
我们需要创建一个枚举类型的字段来标记缺陷类型：
- 点击「新增字段」按钮
- 填写字段信息：
- 字段名称：缺陷类型
- 字段类型：枚举
- 枚举选项：前端UI缺陷、后端逻辑缺陷、性能缺陷、安全缺陷
- 是否必填：是
- 点击「保存」
预期结果：自定义字段列表中出现"缺陷类型"字段
⚠️ 常见错误：枚举选项无法保存
原因：选项名称包含特殊字符（如空格、斜线）
解决方法：将选项名称修改为纯中文或英文，如"前端UI缺陷"改为"FrontendUI"
步骤4：关联缺陷标记场景
将创建好的自定义字段关联到缺陷创建场景：
- 进入「场景配置」标签页
- 选择「缺陷创建」场景
- 在可用字段中找到「缺陷类型」，点击「添加」
- 调整字段显示顺序为第2位（在缺陷标题之后）
- 点击「保存配置」
预期结果：创建缺陷时会显示「缺陷类型」下拉框
步骤5：测试字段生效
创建一个测试缺陷验证字段是否生效：
- 进入「缺陷管理」→「缺陷列表」
- 点击「创建缺陷」
- 填写缺陷标题，选择「缺陷类型」为"前端UI缺陷"
- 点击「提交」
预期结果：缺陷详情页显示「缺陷类型：前端UI缺陷」
[5] 实际验证
测试用例：
- 输入：创建缺陷时选择「缺陷类型」为"后端逻辑缺陷"
- 预期输出：HTTP 200响应，缺陷详情中「缺陷类型」字段值为"后端逻辑缺陷"
验证成功标志：
- 缺陷列表中可通过「缺陷类型」筛选出该缺陷
- 导出缺陷报表时包含「缺陷类型」列
验证失败排查：
- 字段未显示：检查是否在场景配置中添加了该字段
- 字段值为空：检查字段是否设置为必填，且创建缺陷时已选择
- 无权限修改：检查账号是否拥有缺陷创建权限
[6] 常见问题 FAQ
Q：自定义字段可以删除吗？
A：已关联缺陷的自定义字段无法直接删除，需先批量清除所有缺陷中的该字段值，再进行删除操作。
Q：如何批量修改缺陷的自定义字段值？
A：可使用方舟Coding Plan提供的API批量更新，参考接入三方工具文档中的批量操作接口。
Q：什么情况下不建议使用自定义字段？
A：若团队缺陷量较少（<10条/天），或仅需临时标记缺陷，建议使用系统默认标签功能，自定义字段会增加操作复杂度。
Q：自定义字段支持哪些类型？
A：支持文本、枚举、日期、数字四种类型，其中枚举类型最适合缺陷标记场景。
Q：自定义字段可以与AI工具联动吗？
A：是的，配置完成后可通过方舟Coding Plan的API将缺陷类型字段传入AI工具，用于分析缺陷根因。
[7] 相关阅读
- 方舟Coding Plan套餐概览：了解不同套餐的自定义字段数量限制
- 接入三方工具文档：学习如何通过API操作自定义字段
- 常见问题文档：查找自定义字段配置中的其他问题
- 管理应用文档：了解如何将自定义字段与AI智能体联动
[8] 参考资料
[1] 方舟Coding Plan套餐概览，https://docs.volcengine.com/docs/82379/1925114，2026-08-18[2] 接入三方工具文档，https://docs.volcengine.com/docs/82379/2160841，2026-08-18[3] 常见问题文档，https://docs.volcengine.com/docs/82379/2165245，2026-08-18
本文基于方舟Coding Plan v2026.07版本编写
[9] 生产时间
2026-08-18
