SQL表与列含义相同时的列命名规范及实践问询

场景说明 #

现有一个名为instruction的SQL表，结构如下：

CREATE TABLE `instruction` (
    `instruction_id` BIGINT,
    `instruction`    VARCHAR(8192),

    PRIMARY KEY (`instruction_id`)
);

其中instruction列用于存储必填的文本指令，列名与表名重复，显得冗余怪异，针对此场景解答以下问题：

1. 当表中仅有一列与表含义相同时，列命名是否有约定或最佳实践？ #

有明确的约定和最佳实践：

• 核心原则是避免与表名重复，防止写SQL时出现歧义，同时提升可读性。
• 优先使用能精准描述列内容的通用词，比如存储文本内容时常用content、body；如果是简短指令，也可以用text。
• 遵循团队内部统一的命名规范，比如蛇形命名、避免使用SQL关键字，确保命名风格一致。

2. 使用data作为列名是否可行？尽管这个名称可能存在一定误导性。 #

可行，但非常不推荐。data这个名称过于宽泛，无法传递任何具体的业务含义：

• 后续如果表需要扩展其他列（比如created_time、updated_by），data会显得完全模糊，新成员查看表结构时无法快速理解该列的用途。
• 若必须使用宽泛名称，建议结合表名做限定，比如instruction_data，但依然不如content这类精准名称实用。

3. 企业级应用在进行此类规范化时，会如何命名该列？ #

企业级应用通常会从语义清晰、可维护性、团队协作三个维度出发：

• 优先选择精准且简洁的名称，比如针对这个场景，最常用的是content或body，直接表明这是指令的核心文本内容。
• 如果团队习惯用更贴合业务的命名，也会使用instruction_text，虽然包含表名，但能让任何人看到列名就知道它和表的关联以及存储内容。
• 严格遵循内部的命名规范，比如统一使用蛇形命名、避免缩写（除非是全团队公认的缩写），确保跨部门协作时不会因为命名产生理解偏差。

内容的提问来源于stack exchange，提问作者Slevin