comment是字段定义的一部分，加注释必须重写完整列定义，否则会丢失约束、默认值及原有注释；建表时直接添加最安全，语法要求comment紧跟类型与约束后、单引号包裹、内容超长静默截断。
COMMENT 不是补丁，是字段定义的一部分；已有字段加注释必须重写完整列定义，否则会丢约束、丢默认值、清空原有注释。
建表时直接加 COMMENT 最安全
建表阶段就写好注释，既省事又无风险。语法很简单：COMMENT 必须紧跟在字段类型和所有约束（NOT NULL、DEFAULT、AUTO_INCREMENT）之后，不能换行，中间也不能有空格（部分版本容忍空格但不推荐）。
- 注释内容用单引号包裹，内部单引号需转义为两个单引号（
''），别用双引号 - 最大长度 1024 字符，超长会被静默截断，无任何警告
- 表级注释用独立的
COMMENT='xxx'放在语句末尾，和字段注释语法不混用 - 示例：
id BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT'订单ID，全局唯一递增'
ALTER TABLE MODIFY COLUMN 改注释必须带全字段定义
这是最容易翻车的地方：只改注释却漏写 NOT NULL 或 DEFAULT，结果约束被悄悄删掉。MySQL 把 MODIFY 当作“重建列”，没写的属性就按默认值处理——COMMENT 就是空字符串。
- 原字段是
status TINYINT NOT NULL DEFAULT 0，就不能只写MODIFY COLUMN status TINYINT COMMENT'新注释' - 必须复制原定义再加
COMMENT：MODIFY COLUMN status TINYINT NOT NULL DEFAULT 0 COMMENT'0=待处理,1=已完成' - 如果字段是自增主键，
AUTO_INCREMENT要放在COMMENT前面，顺序错会报语法错误 - 大表执行会触发 DDL 锁和可能的表重建，生产环境建议避开高峰
查注释别只靠 SHOW CREATE TABLE
SHOW CREATE TABLE 看起来直观，但对长注释或含换行符的注释容易显示不全甚至换行错位。真正可靠、可脚本化的方式是查系统表。
-
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' - 批量检查或生成文档时，必须用
information_schema，不能依赖人工肉眼核对SHOW CREATE TABLE
批量加注释别手写 ALTER，用元数据动态生成
几十个字段挨个写 ALTER 容易漏、难验证。真实运维场景下，应该从 information_schema.COLUMNS 查出目标列，拼出完整语句。
- 例如给所有含
_at的时间字段统一加注释：SELECT CONCAT('ALTER TABLE `', table_name, '` MODIFY COLUMN `', column_name, '` ', column_type, IF(is_nullable = 'YES', ' NULL', ' NOT NULL'), IF(column_default IS NOT NULL, CONCAT(' DEFAULT ', QUOTE(column_default)), ''), ' COMMENT \'记录', column_name, '时间\'') AS ddl FROM information_schema.COLUMNS ... - 生成的 SQL 要先在测试库跑一遍，确认语法和行为符合预期再上生产
- 注释不是一次性的活——字段逻辑变了，注释也得同步更新，否则比没注释还危险
NOT NULL 或写错 AUTO_INCREMENT 位置，就可能引发线上数据异常；而靠人眼维护几十张表的注释，迟早会过期。真正管用的不是“加了注释”，而是“注释始终和字段定义一致”。
