MySQL中可通过COMMENT属性为字段添加注释,创建表时在字段定义末尾加COMMENT '说明',修改注释需用MODIFY或CHANGE重写完整字段定义,注释存于information_schema.COLUMNS中,最大1024字符。

在 MySQL 中,可以通过 COMMENT 属性为字段(列)添加注释,方便团队理解字段含义、业务用途或数据规则。这个注释会保存在数据字典中,可通过系统表或命令查看,但不会影响 SQL 执行逻辑。
创建表时直接添加字段注释
建表语句中,在字段定义末尾加上 COMMENT '说明文字' 即可:
CREATE TABLE users ( id INT PRIMARY KEY AUTO_INCREMENT COMMENT '用户唯一主键', username VARCHAR(50) NOT NULL COMMENT '登录账号,全局唯一', status TINYINT DEFAULT 1 COMMENT '状态:1-启用,0-禁用,-1-删除' );
修改已有字段的注释
使用 ALTER TABLE ... MODIFY COLUMN 或 CHANGE COLUMN 重写字段定义(注意保留原有类型、约束等),并更新 COMMENT:
- 仅改注释(不改字段名):
ALTER TABLE users MODIFY COLUMN username VARCHAR(50) NOT NULL COMMENT '用户昵称(可为空)'; - 同时改字段名和注释:
ALTER TABLE users CHANGE COLUMN username nick_name VARCHAR(50) COMMENT '用户昵称';
⚠️ 注意:MODIFY 和 CHANGE 都会触发表重建(尤其大表需谨慎),且必须完整写出字段定义(类型、是否允许 NULL、默认值等),否则可能丢失原有约束。
查看字段注释的方法
注释存储在 information_schema.COLUMNS 表中,常用查询方式:
- 查某张表所有字段及注释:
SELECT column_name, column_type, is_nullable, column_default, column_comment FROM information_schema.COLUMNS WHERE table_schema = 'your_db' AND table_name = 'users'; - 用
SHOW CREATE TABLE快速查看(含注释):SHOW CREATE TABLE users;(结果中字段定义后会显示COMMENT 'xxx')
注意事项与建议
字段注释虽小,但对维护性很重要。实际使用中要注意:
- 注释内容建议简洁明确,避免歧义,如“创建时间(UTC+8)”比“时间”更可靠
- MySQL 8.0+ 支持中文注释,但确保数据库、连接、客户端字符集统一为
utf8mb4 - 注释最大长度为 1024 字符,超长会被截断(无警告)
- ORM 框架(如 MyBatis、Hibernate)通常能读取
column_comment并用于生成文档或校验提示










