---
name: kunlun-table
version: 1.1.0
displayName: 表格
tagline: 字段定义、类型约束与跨版本一致性的表格设计口径
description: 表格：字段定义与类型选择、单位与精度规范、枚举与主键设定、表格与文档的分工、跨表一致性与版本控制。含常见设计缺陷清单、合并单元格代价表与验收检查项
categoryIds: [16999]
tags: [表格, 台账, 数据设计, 字段定义, 规范]
license: proprietary
billing: free
---

# 表格

> 表格用着别扭，多半在**设计阶段就埋了坑**：字段含义含糊、单位混在一列里、同一含义在不同表叫不同名、为了好看合并了单元格，从此没法排序筛选。
> 本技能给的是设计口径：字段怎么定义、该放表还是放正文、跨表怎么保持一致、改的时候怎么留痕。

## 一、这个技能解决什么（定位 + 人群）

- **谁用**：建台账与清单的运营与行政、做数据登记与汇总的岗位、需要多人填写同一张表的团队、做报表给上游供数的分析岗。
- **典型场景**：填表人不知道某格填什么，反复来问；同一列里混着"3 天"和"3"；两个系统各自存一份，数字对不上；合并单元格做好看，一排序全乱；改了一版旧版还被人往下传。
- **本技能不做什么**：不接入任何表格软件或数据库；不替你判断涉密数据的存放位置；不处理需要财务或审计签认的法定台账。

## 二、能力地图（6 个能力）

| 能力 | 触发词 | 输入 | 输出 |
|---|---|---|---|
| 字段定义 | 这个字段填什么 | 业务含义 | 字段名 + 数据类型 + 填写说明 |
| 类型选择 | 用文本还是数值 | 字段含义 | 类型结论 + 理由 |
| 规范设定 | 单位/精度/格式 | 字段清单 | 格式规范表 |
| 表文分工 | 放表里还是正文 | 信息项 | 归属结论 |
| 一致性维护 | 两张表对不上 | 多张表 | 命名与口径统一方案 |
| 版本控制 | 改版/留痕/旧版 | 变更内容 | 版本记录 + 兼容说明 |

## 三、字段定义：一个字段写清四件事

| 项 | 要求 | 反例 |
|---|---|---|
| 名称 | 唯一、不含歧义、不含单位词 | "金额（元）"当字段名 |
| 类型 | 文本 / 数值 / 日期 / 枚举，写明一种 | "其他" |
| 约束 | 是否必填、范围、格式 | 不写 |
| 口径 | 怎么算出来的，依据哪份来源 | "以实际情况为准" |

**命名统一**：同一含义在所有表里叫同一个名字。"客户名称""客户名""Customer"三种写法并存，是跨表对不上的头号原因。
**单位不入字段名**：单位写在格式规范里或另起单位行。把"元"写进字段名，遇到"万元"的口径就会造出一列新字段。

## 四、类型选择：别让文本吃掉数值

| 内容 | 类型 | 注意 |
|---|---|---|
| 数量、金额、比率 | 数值 | 不要存成文本，否则算不了 |
| 日期 | 日期 | 统一格式，别混"2026/7/1"与"7月1日" |
| 状态、类别 | 枚举 | 枚举值先定清单，用下拉而非自由填 |
| 编号 | 文本或文本型编码 | 以 0 开头的编号不能用纯数值 |
| 备注 | 文本 | 不加格式约束，但要限长 |

**枚举先行**：状态类的字段先把取值列全再开放填写。开放填写三天后，你会得到七种"已完成"。

## 五、表与正文的分工

| 内容性质 | 放哪里 | 理由 |
|---|---|---|
| 结构化、可比较、会累计 | 表格 | 能排序筛选，能跨期对比 |
| 长段落、因果论述、例外说明 | 正文 | 表格装不下叙述 |
| 少量关键指标 | 表格 | 便于引用 |
| 大量说明文字 | 表格外 | 撑宽列反而难读 |

**判断法**：能被"按某一列排序后仍然讲得通"的内容，适合放表；脱离上下文就失去意义的长句，属于正文。

## 六、合并单元格的代价

| 用途 | 建议 | 代价 |
|---|---|---|
| 表头跨列 | 可以合并 | 影响按列排序 |
| 左侧分组列 | 谨慎 | 影响筛选，且复制时会丢结构 |
| 数据区纵向合并 | 不建议 | 破坏行独立性，无法逐行处理 |
| 小计行 | 单独一列 | 混进数据区会被统计进去 |

**替代方案**：需要展示分组关系时，加一列"分组"并填充，比合并更好处理。

## 七、一致性与版本

| 风险 | 表现 | 对策 |
|---|---|---|
| 同名不同义 | 两张表"活跃用户"算法不同 | 建立口径说明，字段名带范围 |
| 跨表键不一致 | 两边编号规则不同 | 明确主键，统一编码规则 |
| 旧版流传 | 老版本还在被填写 | 文件名带版本，旧版移入归档 |
| 结构变更无记录 | 三个月后发现字段含义变了 | 每次结构变更写一行变更记录 |
| 缺失值无标记 | 空格与"无"分不清 | 统一"未填"标记 |

**变更记录格式**：日期 + 变更项 + 变更前后 + 影响范围。写清是否影响历史数据，不写清楚会导致回头无法比对。

## 八、评分卡（发布前自查）

| 项 | 达标 |
|---|---|
| 每个字段写清类型与填写说明 | 是 / 否 |
| 单位不在字段名里，格式已统一 | 是 / 否 |
| 枚举值已列清单，非自由填写 | 是 / 否 |
| 关键字段已定主键口径 | 是 / 否 |
| 数据区无纵向合并单元格 | 是 / 否 |
| 文件名带版本，旧版已归档 | 是 / 否 |
| 结构变更已留一行记录 | 是 / 否 |

**做不严会怎样**：字段没写清类型，统计时才发现数值被存成文本；单位混进字段名，遇到换口径就得新建一列；枚举开放填写，一周后状态有七种写法；数据区纵向合并，一排序结构全毁；结构变更不留记录，三个月后无法判断两个版本的差异。