项目经理必备:PRD 字段清单完整写法,覆盖列表字段、表单字段、筛选字段、校验规则、枚举值、默认值等,附可复制模板和 5 个真实案例。
前言
字段是 PRD 中最容易漏、最容易对不齐的部分。很多返工都是因为:
- 列表展示的字段和表单编辑的字段不一致
- 筛选条件和列表字段对不上
- 校验规则没写清楚,前后端理解不一致
- 枚举值没统一,导致数据混乱
这篇文章给你一套完整的字段清单模板,覆盖列表/表单/筛选/校验/枚举/默认值,附 5 个真实案例。
一、字段清单的 3 个核心原则
- 列表/表单/筛选必须对齐:同一个字段在不同场景下的含义、格式、枚举值必须一致
- 校验规则必须明确:必填/范围/唯一/组合唯一/正则,不能靠"常识"
- 枚举值必须可追溯:固定枚举/字典表/接口动态,必须说明来源
二、字段清单模板(可直接复制)
字段名: - 中文名称: - 英文字段名(建议): - 含义/业务定义: - 数据类型/格式: - 是否必填: - 默认值: - 取值范围/枚举值: - 枚举值来源(固定/字典表/接口): - 是否可编辑: - 是否可见(按角色): - 是否可导出: - 是否可排序: - 是否可筛选: - 筛选类型(单选/多选/区间/模糊/精确): - 校验规则: - 错误提示文案: - 备注:三、字段三件套:列表/表单/筛选
3.1 列表字段清单
必须明确的内容:
- 展示哪些字段(优先级排序)
- 每个字段的格式(日期格式/金额格式/状态映射)
- 是否可排序(升序/降序)
- 是否可点击(跳转详情/弹窗/下载)
- 操作列(编辑/删除/审批等按钮)
3.2 表单字段清单
必须明确的内容:
- 编辑哪些字段(新增/编辑可能不同)
- 是否必填(前端校验 + 后端校验)
- 输入控件类型(文本框/下拉框/日期选择器/上传)
- 校验规则(长度/范围/格式/唯一性)
- 默认值(系统默认/用户偏好/历史继承)
3.3 筛选字段清单
必须明确的内容:
- 支持哪些筛选字段
- 筛选类型(单选/多选/区间/模糊/精确)
- 筛选项来源(固定/字典表/接口动态)
- 默认筛选条件(是否有默认值)
- 筛选逻辑(AND/OR)
四、5 个真实案例
案例 1:订单列表字段清单
| 字段名 | 列表展示 | 表单编辑 | 筛选支持 | 校验规则 |
|---|---|---|---|---|
| 订单号 | ✓ 可点击 | ✗ 系统生成 | ✓ 精确查询 | - |
| 订单状态 | ✓ 状态标签 | ✗ 不可编辑 | ✓ 多选 | 枚举:待支付/已支付/已发货/已完成/已取消 |
| 下单时间 | ✓ 可排序 | ✗ 系统生成 | ✓ 时间区间 | - |
| 订单金额 | ✓ 可排序 | ✓ 必填 | ✓ 金额区间 | 必填,≥0.01,≤999999.99 |
| 收货地址 | ✗ 不展示 | ✓ 必填 | ✗ 不支持 | 必填,≤200字符 |
案例 2:用户管理字段清单
字段名:用户状态 - 列表展示:✓(状态标签:正常-绿色/禁用-红色) - 表单编辑:✓(下拉框) - 筛选支持:✓(多选) - 枚举值:正常、禁用 - 枚举来源:固定枚举 - 校验规则:必选 - 默认值:正常 字段名:注册时间 - 列表展示:✓(格式:YYYY-MM-DD HH:mm) - 表单编辑:✗(系统生成) - 筛选支持:✓(时间区间) - 校验规则:- - 是否可排序:✓案例 3:商品管理字段清单
字段名:商品分类 - 列表展示:✓ - 表单编辑:✓(级联选择器,最多 3 级) - 筛选支持:✓(多选) - 枚举来源:字典表(category 表) - 校验规则:必选 - 默认值:无 字段名:商品价格 - 列表展示:✓(格式:¥123.45) - 表单编辑:✓(数字输入框) - 筛选支持:✓(价格区间) - 校验规则:必填,≥0.01,≤999999.99,最多 2 位小数 - 默认值:无案例 4:任务管理字段清单
字段名:优先级 - 列表展示:✓(标签:高-红色/中-橙色/低-灰色) - 表单编辑:✓(单选按钮) - 筛选支持:✓(多选) - 枚举值:高、中、低 - 枚举来源:固定枚举 - 校验规则:必选 - 默认值:中 字段名:截止时间 - 列表展示:✓(格式:YYYY-MM-DD,逾期标红) - 表单编辑:✓(日期选择器) - 筛选支持:✓(时间区间) - 校验规则:选填,≥今天 - 默认值:无案例 5:审批流字段清单
字段名:审批状态 - 列表展示:✓(状态标签) - 表单编辑:✗(系统流转) - 筛选支持:✓(多选) - 枚举值:待提交、审批中、已通过、已驳回、已撤回 - 枚举来源:固定枚举 - 校验规则:- - 默认值:待提交 字段名:审批意见 - 列表展示:✗(详情页展示) - 表单编辑:✓(文本域,审批/驳回时必填) - 筛选支持:✗ - 校验规则:审批/驳回时必填,≤500字符 - 默认值:无五、常见问题 FAQ
Q1:列表字段和表单字段不一致怎么办?
建议用一张表格对齐:字段名 | 列表展示 | 表单编辑 | 筛选支持 | 校验规则。这样一眼就能看出哪些字段在哪些场景下出现。
Q2:枚举值是固定还是动态?
建议分类:
- 固定枚举:状态、优先级、性别等(代码写死)
- 字典表:分类、标签、地区等(数据库维护)
- 接口动态:用户列表、部门列表等(接口查询)
Q3:默认值怎么设计?
建议分类:
- 系统默认:固定值(如状态默认"正常")
- 用户偏好:用户上次选择的值
- 历史继承:复制/克隆时继承原数据
Q4:校验规则前端和后端都要写吗?
是的。前端校验提升体验,后端校验保证安全。PRD 里必须明确校验规则,前后端都要实现。
六、工具入口
打开工具:一键生成字段清单思维导图
七、总结
字段清单的核心是"对齐":列表/表单/筛选必须对齐,前端/后端必须对齐,枚举值/校验规则必须对齐。
下一篇建议:需求评审会怎么开(30 分钟高效评审的 5 步流程)。