用 CHANGE，不是 MODIFY。因为 MODIFY 不能改注释，只允许调整数据类型和是否为 NULL，会丢失原有注释；CHANGE 需重写字段定义，可保留并更新 COMMENT。
MySQL 修改字段注释用 MODIFY 还是 CHANGE？
直接说结论：用 CHANGE，不是 MODIFY。因为 MODIFY 不能改注释，它只允许调整数据类型和是否为 NULL，但会丢掉原有注释；而 CHANGE 要求重写整个字段定义，恰好能带入新注释。
常见错误现象：ALTER TABLE t MODIFY COLUMN c INT COMMENT 'new'; 执行成功但注释没变——这就是踩了语法陷阱。
-
CHANGE必须重复写字段名两次（旧名、新名），哪怕不改名也要写一样 - 必须完整写出字段类型、约束（如
NOT NULL）、默认值等，否则会被重置为默认状态 - 如果字段有
DEFAULT值或GENERATED表达式，漏写会导致它们被清空
给已有字段加注释的最小安全写法
核心原则：先查原定义，再照抄修改，只动 COMMENT 部分。别凭记忆手写。
实操步骤：
- 用
SHOW CREATE TABLE <table_name>;</table_name>查出字段当前完整定义 - 复制对应字段那一行（例如：
`status` tinyint(4) NOT NULL DEFAULT '0' COMMENT '订单状态'） - 把
COMMENT内容替换成新注释，其他部分一字不动 - 套进
ALTER TABLE ... CHANGE语句中，注意字段名写两遍
示例（给 user 表的 nick 字段加注释）：
ALTER TABLE user CHANGE COLUMN nick nick VARCHAR(50) NOT NULL COMMENT '用户昵称，仅前台显示';
为什么不用 ALTER TABLE ... ALTER COLUMN ... SET COMMENT？
这是 MySQL 8.0.13+ 新增的语法，看着更干净，但它只适用于 ADD COLUMN 后立刻设置注释，或者配合 MODIFY COLUMN 改类型时顺带更新注释——但单独改注释仍不支持。
也就是说：ALTER TABLE t ALTER COLUMN c SET COMMENT 'xxx'; 在当前主流版本（如 5.7、8.0.12 及更早）会报错 ERROR 1064，提示语法错误。
- 该语法在 8.0.13+ 中可用，但仅限于「已有字段」且「不改变类型/约束」的纯注释更新
- 多数生产环境还没升级到支持版本，盲目使用等于埋雷
- 兼容性优先时，
CHANGE是唯一稳态方案
注释里不能写什么？特殊字符和长度限制
MySQL 对 COMMENT 内容本身不做语义校验，但有两个硬限制容易被忽略：
- 最大长度 1024 字符（含空格、换行），超长会被截断，且不报错
- 单引号、双引号、反斜杠要转义，否则可能破坏 SQL 解析（尤其用程序拼接时）
- 注释里写
/* */或--不会触发注释解析，只是普通文本，但可能干扰人工阅读
建议：注释用英文逗号分隔关键信息，避免嵌套引号，上线前用 SELECT COLUMN_COMMENT FROM INFORMATION_SCHEMA.COLUMNS 核对是否完整入库。
真正麻烦的是跨版本迁移——低版本导出的建表语句里注释可能被忽略，高版本导入时得手动补。这事没法靠语法规避，只能靠流程卡点。
