mysql如何给字段添加注释说明_使用Comment关键字提高可读性-mysql教程-PHP中文网

MySQL中给已有字段加注释必须用ALTER TABLE ... MODIFY COLUMN或CHANGE COLUMN并重申完整字段定义，不可仅写COMMENT；建表时COMMENT须置于字段定义末尾且不超过1024字符。

mysql如何给字段添加注释说明_使用comment关键字提高可读性

ALTER TABLE 添加字段注释的正确写法

MySQL 中给已有字段加注释，必须用 ALTER TABLE ... MODIFY COLUMN 或 ALTER TABLE ... CHANGE COLUMN，不能只写 COMMENT。直接执行 ALTER TABLE t1 COMMENT 'xxx' 是给表加注释，不是字段。

关键点：字段注释必须随字段定义一起重申，哪怕类型、约束完全不变，也得把原定义复制过来，再加 COMMENT 子句。

MODIFY COLUMN 适用于仅改注释、不改字段名的场景（推荐）
CHANGE COLUMN 要求重复写两次字段名（旧名、新名），稍易出错
如果字段有默认值、非空等约束，这些都得原样带上，漏掉会清空对应属性

示例：给 users.name 字段加注释

ALTER TABLE users MODIFY COLUMN name VARCHAR(50) NOT NULL COMMENT '用户真实姓名，最多50个字符';

CREATE TABLE 时直接写 COMMENT 的注意事项

建表时加注释最简单，但容易忽略两个细节：一是 COMMENT 必须写在字段定义末尾，二是注释内容长度不能超过 1024 字符（MySQL 8.0+），超长会被截断且无警告。

注释中不要用单引号嵌套，避免 SQL 解析失败；用双引号或转义处理
中文注释无需额外编码设置，只要连接字符集是 utf8mb4 即可正常存储
如果字段是自增主键，COMMENT 要放在 AUTO_INCREMENT 后面，顺序错会导致语法错误

示例：

MySQL

编写正确的MySQL查询，避免字符集、索引和锁方面的常见陷阱。

下载

CREATE TABLE orders (
  id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '订单唯一ID，全局递增',
  status TINYINT NOT NULL COMMENT '订单状态：0-待支付，1-已支付，2-已发货'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

查看字段注释的三种可靠方式

很多人用 SHOW CREATE TABLE 查注释，但它对长注释可能换行截断；更稳妥的是查 information_schema.COLUMNS 表。

SHOW FULL COLUMNS FROM table_name —— 最快，但注释列名是 Comment（首字母大写），容易看漏
SELECT COLUMN_NAME, COLUMN_COMMENT FROM information_schema.COLUMNS WHERE TABLE_SCHEMA = 'db_name' AND TABLE_NAME = 'table_name' —— 精准，支持 WHERE 过滤
SHOW CREATE TABLE table_nameG —— 加 G 可读性好，但注意注释里若有换行符，可能显示为 \n

别依赖 DESCRIBE table_name，它不显示 COMMENT 内容。