字段清单三件套：列表/表单/筛选（附10个常见字段模板）-酒店常州论坛

前言

字段三件套（列表/表单/筛选）是PRD中最容易对不齐的部分。很多返工都是因为：列表展示的字段和表单编辑的不一致、筛选条件和列表字段对不上。这篇给你完整的对齐方法+10个常见字段模板。

一、字段三件套对齐表

字段名	列表展示	表单编辑	筛选支持	备注
订单号	✓ 可点击	✗ 系统生成	✓ 精确查询	-
订单状态	✓ 状态标签	✗ 不可编辑	✓ 多选	-
下单时间	✓ 可排序	✗ 系统生成	✓ 时间区间	-
订单金额	✓ 可排序	✓ 必填	✓ 金额区间	-
收货地址	✗ 不展示	✓ 必填	✗ 不支持	详情页展示

二、10个常见字段模板

模板1：状态字段

字段名：订单状态 列表展示：✓（状态标签，不同颜色） 表单编辑：✗（系统流转） 筛选支持：✓（多选） 枚举值：待支付、已支付、已发货、已完成、已取消 默认值：待支付

模板2：时间字段

字段名：创建时间 列表展示：✓（格式：YYYY-MM-DD HH:mm） 表单编辑：✗（系统生成） 筛选支持：✓（时间区间） 是否可排序：✓ 默认排序：降序

模板3：金额字段

字段名：订单金额 列表展示：✓（格式：¥123.45） 表单编辑：✓（数字输入框） 筛选支持：✓（金额区间） 校验规则：必填，≥0.01，≤999999.99，最多2位小数 是否可排序：✓

模板4：分类字段

字段名：商品分类 列表展示：✓（显示分类名称） 表单编辑：✓（级联选择器，最多3级） 筛选支持：✓（多选） 枚举来源：字典表（category表） 校验规则：必选

模板5：用户字段

字段名：负责人 列表展示：✓（显示用户名） 表单编辑：✓（用户选择器） 筛选支持：✓（多选） 枚举来源：接口动态（/api/users） 校验规则：必选

模板6：文本字段

字段名：备注 列表展示：✗（详情页展示） 表单编辑：✓（文本域） 筛选支持：✗ 校验规则：选填，≤500字符

模板7：图片字段

字段名：商品图片 列表展示：✓（缩略图） 表单编辑：✓（图片上传，最多9张） 筛选支持：✗ 校验规则：选填，单张≤2MB，支持jpg/png

模板8：开关字段

字段名：是否启用 列表展示：✓（开关样式） 表单编辑：✓（开关） 筛选支持：✓（单选：全部/启用/禁用） 默认值：启用

模板9：优先级字段

字段名：优先级 列表展示：✓（标签：高-红色/中-橙色/低-灰色） 表单编辑：✓（单选按钮） 筛选支持：✓（多选） 枚举值：高、中、低 默认值：中

模板10：关联字段

字段名：关联订单 列表展示：✓（可点击跳转） 表单编辑：✓（订单选择器） 筛选支持：✓（精确查询） 枚举来源：接口动态（/api/orders） 校验规则：选填

三、字段对齐方法

方法1：使用对齐表

创建字段对齐表，统一管理列表、表单、筛选三个场景的字段配置。

字段对齐表模板： | 字段名 | 字段类型 | 列表展示 | 表单编辑 | 筛选支持 | 排序 | 默认值 | 备注 | |--------|---------|---------|---------|---------|------|--------|------| | 订单号 | 文本 | ✓ 可点击 | ✗ 系统生成 | ✓ 精确查询 | - | - | 跳转详情 | | 订单状态 | 枚举 | ✓ 状态标签 | ✗ 系统流转 | ✓ 多选 | - | 待支付 | - | | 下单时间 | 日期 | ✓ 可排序 | ✗ 系统生成 | ✓ 时间区间 | ✓ | - | 降序 | | 订单金额 | 金额 | ✓ 可排序 | ✓ 必填 | ✓ 金额区间 | ✓ | - | ¥格式 | | 收货地址 | 文本 | ✗ 不展示 | ✓ 必填 | ✗ 不支持 | - | - | 详情页展示 |

方法2：字段配置化

将字段配置化，统一管理字段的展示、编辑、筛选规则。

字段配置示例（JSON）： { "order_no": { "name": "订单号", "type": "text", "list": { "show": true, "clickable": true, "link": "/orders/{id}" }, "form": { "editable": false, "source": "system" }, "filter": { "supported": true, "type": "exact" } }, "status": { "name": "订单状态", "type": "enum", "list": { "show": true, "format": "tag" }, "form": { "editable": false, "source": "system" }, "filter": { "supported": true, "type": "multiple" }, "enum": { "source": "fixed", "values": ["待支付", "已支付", "已发货", "已完成", "已取消"] } } }

方法3：对齐检查工具

开发对齐检查工具，自动检查字段配置是否一致。

检查规则： 1. 列表字段和表单字段是否一致？ - 列表中的字段，表单中是否可编辑？ - 表单中的必填字段，列表中是否展示？ 2. 筛选字段是否都在列表中展示？ - 筛选支持的字段，列表中是否展示？ - 筛选字段的枚举值是否和列表一致？ 3. 枚举值来源是否明确？ - 固定枚举：值是否明确？ - 字典表：表名和字段是否明确？ - 接口动态：接口地址和参数是否明确？ 4. 必填字段是否标注？ - 表单中必填字段是否标注*？ - 校验规则是否完整？ 5. 可排序字段是否标注？ - 列表中可排序字段是否显示排序图标？ - 默认排序是否明确？

四、实际案例

案例1：订单管理字段对齐

业务场景：订单列表、订单表单、订单筛选需要对齐。

字段对齐表： | 字段名 | 列表展示 | 表单编辑 | 筛选支持 | 对齐状态 | |--------|---------|---------|---------|---------| | 订单号 | ✓ | ✗ 系统生成 | ✓ 精确查询 | ✓ 对齐 | | 订单状态 | ✓ 状态标签 | ✗ 系统流转 | ✓ 多选 | ✓ 对齐 | | 下单时间 | ✓ 可排序 | ✗ 系统生成 | ✓ 时间区间 | ✓ 对齐 | | 订单金额 | ✓ 可排序 | ✓ 必填 | ✓ 金额区间 | ✓ 对齐 | | 收货地址 | ✗ 不展示 | ✓ 必填 | ✗ 不支持 | ✓ 对齐（详情页展示） | | 备注 | ✗ 不展示 | ✓ 选填 | ✗ 不支持 | ✓ 对齐（详情页展示） | 对齐检查： ✓ 列表字段和表单字段一致 ✓ 筛选字段都在列表中展示（或详情页展示） ✓ 枚举值来源明确 ✓ 必填字段标注 ✓ 可排序字段标注

案例2：客户管理字段对齐

业务场景：客户列表、客户表单、客户筛选需要对齐。

字段对齐表： | 字段名 | 列表展示 | 表单编辑 | 筛选支持 | 对齐状态 | |--------|---------|---------|---------|---------| | 客户名称 | ✓ | ✓ 必填 | ✓ 模糊查询 | ✓ 对齐 | | 联系人 | ✓ | ✓ 必填 | ✓ 模糊查询 | ✓ 对齐 | | 手机号 | ✓ 脱敏 | ✓ 必填 | ✓ 精确查询 | ✓ 对齐 | | 邮箱 | ✗ 不展示 | ✓ 选填 | ✗ 不支持 | ✓ 对齐（详情页展示） | | 公司地址 | ✗ 不展示 | ✓ 选填 | ✗ 不支持 | ✓ 对齐（详情页展示） | | 客户等级 | ✓ 标签 | ✓ 必选 | ✓ 多选 | ✓ 对齐 | | 创建时间 | ✓ 可排序 | ✗ 系统生成 | ✓ 时间区间 | ✓ 对齐 | 对齐检查： ✓ 列表字段和表单字段一致 ✓ 筛选字段都在列表中展示（或详情页展示） ✓ 枚举值来源明确（客户等级：字典表） ✓ 必填字段标注 ✓ 可排序字段标注

案例3：商品管理字段对齐

业务场景：商品列表、商品表单、商品筛选需要对齐。

字段对齐表： | 字段名 | 列表展示 | 表单编辑 | 筛选支持 | 对齐状态 | |--------|---------|---------|---------|---------| | 商品名称 | ✓ | ✓ 必填 | ✓ 模糊查询 | ✓ 对齐 | | 商品分类 | ✓ | ✓ 必选 | ✓ 多选 | ✓ 对齐 | | 商品价格 | ✓ 可排序 | ✓ 必填 | ✓ 价格区间 | ✓ 对齐 | | 商品图片 | ✓ 缩略图 | ✓ 必填 | ✗ 不支持 | ✓ 对齐 | | 商品描述 | ✗ 不展示 | ✓ 选填 | ✗ 不支持 | ✓ 对齐（详情页展示） | | 库存数量 | ✓ | ✓ 必填 | ✓ 数量区间 | ✓ 对齐 | | 上架状态 | ✓ 开关 | ✓ 开关 | ✓ 单选 | ✓ 对齐 | 对齐检查： ✓ 列表字段和表单字段一致 ✓ 筛选字段都在列表中展示（或详情页展示） ✓ 枚举值来源明确（商品分类：字典表，上架状态：固定枚举） ✓ 必填字段标注 ✓ 可排序字段标注

五、常见错误

错误1：列表字段和表单字段不一致

问题：列表中展示的字段，表单中不能编辑；表单中必填的字段，列表中不展示。

❌ 错误示例： 列表字段：订单号、订单状态、订单金额 表单字段：订单金额、收货地址、备注 问题： - 列表中展示订单状态，但表单中不能编辑（不一致） - 表单中必填收货地址，但列表中不展示（不一致） ✅ 正确示例： 列表字段：订单号、订单状态、订单金额、收货地址（或详情页展示） 表单字段：订单金额、收货地址、备注 - 订单状态：列表展示，表单不编辑（系统流转，一致） - 收货地址：列表展示或详情页展示，表单必填（一致）

错误2：筛选字段不在列表中展示

问题：筛选支持的字段，列表中不展示，用户无法确认筛选结果。

❌ 错误示例： 筛选字段：订单状态、订单金额、下单时间 列表字段：订单号、订单金额、下单时间（缺少订单状态） 问题：用户筛选订单状态后，列表中看不到订单状态，无法确认筛选结果。 ✅ 正确示例： 筛选字段：订单状态、订单金额、下单时间 列表字段：订单号、订单状态、订单金额、下单时间（包含所有筛选字段）

错误3：枚举值来源不明确

问题：枚举值的来源不明确，开发人员不知道从哪里获取。

❌ 错误示例： 字段：商品分类 枚举值：不明确（是固定枚举？字典表？接口动态？） ✅ 正确示例： 字段：商品分类 枚举值来源：字典表（dict_category） - 表名：dict_category - 字段：id, name, parent_id - 支持层级：最多3级 - 前端接口：/api/dict/category

错误4：必填字段未标注

问题：表单中必填字段没有标注，用户不知道哪些字段必填。

❌ 错误示例： 表单字段：订单金额、收货地址、备注 必填字段：未标注 ✅ 正确示例： 表单字段： - 订单金额：* 必填 - 收货地址：* 必填 - 备注：选填

错误5：可排序字段未标注

问题：列表中可排序字段没有标注，用户不知道哪些字段可以排序。

❌ 错误示例： 列表字段：订单号、订单状态、下单时间、订单金额 可排序字段：未标注 ✅ 正确示例： 列表字段： - 订单号：不可排序 - 订单状态：不可排序 - 下单时间：可排序（默认降序）↑↓ - 订单金额：可排序 ↑↓

六、最佳实践

实践1：使用对齐表统一管理

创建字段对齐表，统一管理列表、表单、筛选三个场景的字段配置。

✓ 正确做法： - 使用Excel或在线表格创建字段对齐表 - 统一管理所有字段的配置 - 定期检查对齐表，确保字段一致 ✗ 错误做法： - 列表、表单、筛选分别写文档 - 没有统一管理，容易不一致

实践2：字段配置化

将字段配置化，统一管理字段的展示、编辑、筛选规则。

✓ 正确做法： - 使用JSON或YAML配置文件管理字段 - 前端和后端共享配置 - 配置变更不需要修改代码 ✗ 错误做法： - 字段配置硬编码在代码中 - 前端和后端配置不一致

实践3：对齐检查工具

开发对齐检查工具，自动检查字段配置是否一致。

检查工具功能： - 检查列表字段和表单字段是否一致 - 检查筛选字段是否都在列表中展示 - 检查枚举值来源是否明确 - 检查必填字段是否标注 - 检查可排序字段是否标注

实践4：定期对齐检查

定期检查字段对齐情况，发现不一致及时修复。

检查频率： - 开发阶段：每次修改字段时检查 - 测试阶段：测试前全面检查 - 上线前：上线前最后检查

七、对齐检查清单

□ 列表字段和表单字段是否一致？ □ 筛选字段是否都在列表中展示？ □ 枚举值来源是否明确（固定/字典表/接口）？ □ 必填字段在表单中是否标注？ □ 可排序字段是否在列表中标注？ □ 默认值是否明确？ □ 校验规则是否完整？ □ 字段格式是否一致（日期、金额、状态等）？ □ 字段长度是否一致（列表和表单）？ □ 字段顺序是否合理（列表和表单）？

八、FAQ

Q1：列表字段太多怎么办？

答：建议：核心字段固定展示，其他字段支持自定义显示/隐藏。

解决方案：

核心字段固定：订单号、状态、金额等核心字段固定展示
其他字段可选：备注、地址等字段支持自定义显示/隐藏
详情页展示：不常用的字段在详情页展示，不在列表展示
分页展示：如果字段确实很多，可以考虑分页或标签页展示

Q2：筛选字段和列表字段必须一致吗？

答：不一定。但筛选字段最好在列表中展示，方便用户确认筛选结果。

原则：

筛选字段建议在列表展示：用户筛选后，需要在列表中看到筛选结果
列表字段不一定需要筛选：某些字段（如订单号）可以展示但不支持筛选
详情页字段可以不筛选：详情页展示的字段（如备注）可以不支持筛选

示例： 筛选字段：订单状态、订单金额、下单时间 列表字段：订单号、订单状态、订单金额、下单时间 说明： - 订单状态：筛选支持，列表展示（一致） - 订单金额：筛选支持，列表展示（一致） - 下单时间：筛选支持，列表展示（一致） - 订单号：筛选支持（精确查询），列表展示（一致） - 备注：筛选不支持，列表不展示（详情页展示）

Q3：表单字段和列表字段必须一致吗？

答：不一定。但列表展示的字段，表单中应该可以编辑（系统生成的字段除外）。