ThinkPHP的Db::getFields()不返回字段注释，需手动查询information_schema.columns获取column_comment；注意权限、MySQL版本、字符集及云数据库限制，并配合白名单控制敏感字段展示。
ThinkPHP 读取数据库字段注释用 Db::getFields() 不够，得查 information_schema
ThinkPHP 自带的 Db::getFields() 返回的是字段名、类型、长度等基础信息，但默认不包含 comment（即字段注释）。很多同学试了发现 $fields['name']['comment'] 是空的，不是代码写错了，是底层没查这张表。
真正存注释的地方在 MySQL 的 information_schema.columns 表里。要拿到注释，得手动查一次：
SELECT column_name, column_comment FROM information_schema.columns WHERE table_schema = 'your_db_name' AND table_name = 'your_table_name';
注意替换 your_db_name 和 your_table_name，且确保当前数据库用户有查 information_schema 的权限——线上环境有时会被禁掉，这是第一个容易卡住的地方。
自动生成表单标签时，别直接硬编码 label 文本，优先从注释映射
字段注释本质就是业务语义描述，比如 user_name 注释是“用户昵称”，那就该直接当 label 用，而不是在模板里写死 <label>用户昵称</label>。
立即学习“PHP免费学习笔记（深入）”；
实操建议分两步走：
- 在控制器或服务层，把字段名和注释组装成键值对，例如：
['user_name' => '用户昵称', 'status' => '状态'] - 传给模板后，用
foreach动态生成<input>+<label>，label 内容取数组值，而非字段名 - 对没有注释的字段，fallback 到中文转换逻辑（如
snake_case→ “用户昵称”），但别强求全自动，人工补注释更稳
别指望框架自动帮你做这层映射——ThinkPHP 没内置这个能力，得自己桥接。
Db::query() 查注释时，注意 MySQL 版本和字符集影响 column_comment 显示
MySQL 5.7+ 才完整支持 column_comment 字段；低于这个版本可能返回空或乱码。另外，如果建表时用的字符集不是 utf8mb4，注释含中文时很可能显示为问号或截断。
验证方式很简单：
SHOW CREATE TABLE your_table_name;
看输出里字段定义后面有没有 COMMENT 'xxx'，以及内容是否正常。如果建表语句里就有注释但查出来是空，大概率是连接字符集没设对，在数据库配置里加 'charset' => 'utf8mb4'。
还有一个隐藏坑：某些云数据库（比如阿里云 RDS）会屏蔽 information_schema 的部分列，column_comment 可能被过滤，这时只能靠建表 SQL 或文档维护注释。
注释不是万能的，敏感字段（如密码、token）绝不能靠注释驱动表单生成
自动生成表单时，很容易图省事，把所有字段都套一层 label + input。但像 password_hash、api_token 这类字段，即使注释写了“密码哈希值”，也不该出现在普通表单里。
必须显式白名单控制可渲染字段：
- 定义一个允许表单展示的字段数组，比如
$form_fields = ['username', 'email', 'avatar'] - 遍历前先
array_intersect_key()过滤，别直接 foreach 全表字段 - 对类型为
password、hidden的字段，强制跳过或改用其他交互形式（如“重置密码”按钮）
注释只是辅助语义，不是安全边界。这点一旦忽略，轻则表单错乱，重则暴露敏感字段。
