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 并用于生成文档或校验提示