CREATE TABLE时直接添加COMMENT最省事，表注释置于语句末尾、字段注释紧跟定义后；ALTER TABLE需用COMMENT改表注释、MODIFY/CHANGE COLUMN改字段注释；查看用SHOW CREATE TABLE或information_schema。
CREATE TABLE 时直接添加 COMMENT
建表阶段就写好注释最省事，也最不容易遗漏。MySQL 支持在 CREATE TABLE 语句里为整张表和每个字段分别加 COMMENT，语法清晰且一次到位。
注意：表级 COMMENT 必须放在括号外、语句末尾；字段级 COMMENT 则紧跟在字段定义之后。
CREATE TABLE users ( id INT PRIMARY KEY, name VARCHAR(50) COMMENT '用户真实姓名', status TINYINT COMMENT '0-禁用,1-启用,2-待审核' ) COMMENT='用户主表，含基础身份与状态信息';
常见错误是把表注释写在括号内，或漏掉单引号——MySQL 会直接报错 ERROR 1064。
ALTER TABLE 修改已有表的 COMMENT
对已上线的表补注释，必须用 ALTER TABLE ... COMMENT（改表注释）或 MODIFY COLUMN/CHANGE COLUMN（改字段注释）。不能只写 ALTER TABLE ... COMMENT 来改字段，那是无效的。
- 修改表注释：
ALTER TABLE users COMMENT='用户主表（含历史迁移数据）'; - 修改字段注释（保留原类型）：
ALTER TABLE users MODIFY COLUMN name VARCHAR(50) COMMENT '用户注册时填写的名称'; - 若字段名也要改，用
CHANGE COLUMN，但需重复写类型：ALTER TABLE users CHANGE COLUMN name full_name VARCHAR(50) COMMENT '用户全名';
执行后不会影响数据，但 DDL 操作在大表上仍可能触发元数据锁，建议避开高峰期。
如何查看已有的 COMMENT 内容
注释不是摆设，得能快速查到。最常用的是 SHOW CREATE TABLE，它会原样输出建表语句，包括所有 COMMENT。
如果只想看字段注释，SHOW FULL COLUMNS FROM users 更直观，结果中 Comment 列就是对应字段的说明。
注意：DESCRIBE users 或 SHOW COLUMNS 不显示注释，容易误判为没生效。
想批量查所有表的注释？查 information_schema.TABLES 和 COLUMNS 表：
SELECT table_name, table_comment FROM information_schema.TABLES WHERE table_schema = 'your_db_name';
COMMENT 的长度限制与实际用途
MySQL 对 COMMENT 长度有硬限制：表注释最多 2048 字符，字段注释最多 1024 字符（MySQL 8.0+），超长会被截断且不报错——你得自己检查是否完整存进去了。
真正关键的是：这些注释不会被 MySQL 自动用于查询优化或约束校验，纯属文档性质。但很多 ORM 工具（如 Django、Laravel）和数据库建模工具（如 PowerDesigner、DBeaver）会读取并展示它们，所以写清楚「业务含义」比写「技术类型」更有价值。
比如写 COMMENT='订单创建时间（UTC）' 比 COMMENT='datetime column' 有用得多；避免用缩写，除非团队内有统一定义。
