给字段加注释必须用 ALTER TABLE ... MODIFY COLUMN 或 CHANGE COLUMN 重申完整字段定义，包括类型、约束和默认值，否则属性会丢失；COMMENT 需置于 AUTO_INCREMENT 等约束之后，顺序错误将报语法错误。
给已有字段加注释，不能只写 COMMENT；必须用 ALTER TABLE ... MODIFY COLUMN 或 ALTER TABLE ... CHANGE COLUMN 重申整个字段定义，否则注释不会生效。
ALTER TABLE MODIFY COLUMN 是最常用的方式
适用于仅修改注释、不改字段名的场景。关键点是：字段类型、约束（NOT NULL、DEFAULT、AUTO_INCREMENT 等）必须原样照抄，漏掉任何一项都会导致属性被清空。
-
MODIFY COLUMN不允许改字段名，语义更清晰，出错概率低 - 如果原字段是
id BIGINT PRIMARY KEY AUTO_INCREMENT，COMMENT必须放在AUTO_INCREMENT后面，顺序错会报语法错误 - 大表执行会触发重建，可能锁表较久；生产环境建议在低峰期操作
- 示例：
ALTER TABLE users MODIFY COLUMN email VARCHAR(100) NOT NULL DEFAULT '' COMMENT '用户注册邮箱，去重校验'
CHANGE COLUMN 适合要同时改名+加注释的情况
需要重复写两次字段名（旧名、新名），稍易手误。但如果你本来就要改字段名，顺带加注释就不用拆成两步。
- 语法是
CHANGE COLUMN old_name new_name type ... COMMENT 'xxx' - 哪怕新旧名一样，也得写两遍，比如
CHANGE COLUMN name name VARCHAR(50) ... - 漏写第一个字段名会直接报错
ERROR 1064；漏写第二个则变成改类型而非改名 - 和
MODIFY一样，所有约束都得显式带上，不能省略
查看注释别只信 SHOW CREATE TABLE
SHOW CREATE TABLE 显示直观，但长注释可能被截断或换行显示为 \n，容易误判是否完整存入。真正可靠的是查系统表。
- 查单个字段：
SELECT COLUMN_COMMENT FROM information_schema.COLUMNS WHERE TABLE_SCHEMA = 'your_db' AND TABLE_NAME = 'users' AND COLUMN_NAME = 'email' - 查整张表所有带注释的字段：
SELECT COLUMN_NAME, COLUMN_COMMENT FROM information_schema.COLUMNS WHERE TABLE_SCHEMA = 'your_db' AND TABLE_NAME = 'users' AND COLUMN_COMMENT != '' -
SHOW FULL COLUMNS FROM users也能看，但列名是Comment（首字母大写），容易忽略 - 别用
DESCRIBE users—— 它压根不返回COLUMN_COMMENT
COMMENT 字符串里有单引号或超长怎么办
注释本质是 SQL 字符串字面量，受标准字符串规则约束。处理不当会导致语法错误或静默截断。
- 单引号必须转义：写成两个单引号，例如
COMMENT '用户''s手机号'，而不是'用户's手机号' - 最大长度 1024 字符，超长会被静默截断，无警告、无报错 —— 加完务必用上面的
information_schema查询验证 - 换行符可以保留，但某些客户端或驱动（如老版本 JDBC）需额外配置才支持多行解析
- 中文无需特殊编码，只要连接字符集是
utf8mb4就能正常存取
最容易被忽略的是：改注释不是“打补丁”，而是“重定义字段”。哪怕只动一个字的注释，也要把字段类型、约束、默认值全写一遍。漏掉 NOT NULL 或 DEFAULT，下次 INSERT 就可能失败。
