MySQL 5.7+ 给已有字段补注释需用 MODIFY COLUMN 或 CHANGE COLUMN 配合 COMMENT；单独 ADD COLUMN COMMENT 仅适用于新增字段，查看注释应查 information_schema.COLUMNS 或用 SHOW CREATE TABLE。
ALTER TABLE 添加字段注释的正确写法
MySQL 5.7+ 支持直接在 ALTER TABLE 中用 COMMENT 给字段加注释，但必须配合 MODIFY COLUMN 或 CHANGE COLUMN，不能只写 COMMENT —— 单独用 ALTER TABLE ... COMMENT 是给整张表加注释的，不是字段。
常见错误是这么写：ALTER TABLE user ADD COLUMN name VARCHAR(50) COMMENT '用户名' —— 这条本身没错，但如果是想「给已有字段补注释」，就必须重定义字段类型：
ALTER TABLE user MODIFY COLUMN name VARCHAR(50) COMMENT '用户名';- 或更稳妥的写法（保留原字段名）：
ALTER TABLE user CHANGE COLUMN name name VARCHAR(50) COMMENT '用户名';
注意：两种方式都会触发表重建（尤其大表要谨慎），MODIFY 要求类型完全一致，CHANGE 允许同时改名和类型，但多一个参数，容易手抖漏写字段名。
查看字段注释的三种可靠方式
字段注释存在 information_schema.COLUMNS 表里，不是所有客户端都默认展示。别依赖 DESCRIBE table_name 或 SHOW COLUMNS —— 它们在某些 MySQL 版本或客户端里会省略 COLUMN_COMMENT 列。
- 查单个字段：
SELECT COLUMN_NAME, COLUMN_COMMENT FROM information_schema.COLUMNS WHERE TABLE_SCHEMA = 'your_db' AND TABLE_NAME = 'user' AND COLUMN_NAME = 'name'; - 查整张表所有带注释的字段：
SELECT COLUMN_NAME, DATA_TYPE, COLUMN_COMMENT FROM information_schema.COLUMNS WHERE TABLE_SCHEMA = 'your_db' AND TABLE_NAME = 'user' AND COLUMN_COMMENT != ''; - 用
SHOW CREATE TABLE user\G（注意末尾\G），输出里每个字段定义后紧跟COMMENT，最直观，但不便于脚本解析。
COMMENT 字符串里的单引号和换行怎么处理
MySQL 的 COMMENT 值本质是字符串字面量，受 SQL 字符串规则约束。如果你写 COMMENT '用户's姓名'，会报错 ERROR 1064 (42000) —— 因为单引号没转义。
- 单引号必须写成两个单引号：
COMMENT '用户''s姓名' - 换行符可以保留，但需确保客户端/驱动支持（比如 Python 的
mysql-connector默认允许，但某些老版本 JDBC 需设allowMultiQueries=true） - 最大长度是 1024 字符，超长会被静默截断，不会报错，也查不到警告 —— 所以加完务必用前面说的方法验证是否完整存进去了。
COMMENT 不生效的典型场景
注释不是元数据“强约束”，它只是存储在系统表里的一段文本，很多工具链根本不读它。最容易被忽略的是：
- ORM 框架（如 Django、SQLAlchemy）默认不读取
COLUMN_COMMENT，生成 model 时注释就丢了；得额外配插件或手动补 - mysqldump 默认不导出
COMMENT，除非加--comments参数 - MySQL 5.6 及更早版本对
COMMENT支持不完整，比如TEXT类型字段加注释可能失败，升级前先测 - 字段类型变更时如果没显式带上
COMMENT，原有注释会被清空 —— 例如MODIFY COLUMN name VARCHAR(100)不写COMMENT，原来的注释就没了。
真正要用好 COMMENT，得把它当成文档的一部分来维护，而不是加完就不管。尤其是多人协作时，字段含义变了但注释没同步，比没注释还危险。
