ThinkPHP 表名必须严格使用小写+下划线格式，否则会导致解析失败、字段映射错位及链式方法异常；需显式声明 $table 属性指定真实表名，禁用自动推导，并同步规范数据库、配置与模型三层命名。
ThinkPHP 表名不统一，90% 是因为没踩准框架对「小写+下划线」的硬性过滤逻辑——不是风格问题，是功能失效风险。
为什么 think_user 能用，User、UserInfo、user_info_t 全报错？
ThinkPHP（5.0+）默认使用 think_ 前缀 + 小写+下划线命名的数据表，且在模型解析、字段自动映射、查询构造器中会主动过滤掉以下命名：
- 含大写字母的表名（如
UserInfo、user_info_t）→ 解析时被截断或忽略 - 以下划线开头的表名（如
_user）→ 被Db::name()或模型自动过滤掉 - 含驼峰、中文、空格、特殊符号的表名 → 无法通过
parseTable()方法识别，直接抛出InvalidArgumentException
这不是警告，是运行时拦截。哪怕你手动写 SQL，Db::table('UserInfo') 也会被底层强制转成 userinfo，再拼上前缀变成 think_userinfo，和实际表名对不上。
model 类里怎么指定真实表名才不被覆盖？
必须显式声明 $table 属性，且值为完整、准确的小写+下划线表名（不含前缀），否则框架按类名推导会出错：
立即学习“PHP免费学习笔记（深入）”；
-
UserModel类默认推导表名为user→ 实际要映射sys_user？得写：protected $table = 'sys_user'; - 如果数据库用了
think_前缀（默认开启），$table仍只填后半段，前缀由database.prefix配置控制，不要重复加 - 避免在
initialize()里动态设$this->table—— 模型初始化阶段已错过表名解析时机 - 使用
Db::name('sys_user')比Db::table('sys_user')更安全，前者走命名规范校验，后者绕过校验但易失控
已有驼峰/混合命名的旧库怎么平滑迁移？
不能靠改模型硬扛，得从三处同步约束：
- 数据库层面：用
RENAME TABLE批量转表名（例如ALTER TABLE UserInfo RENAME TO user_info;），MySQL 8.0+ 支持脚本化操作 - 配置层面：在
config/database.php中确认'prefix' => 'think_'与实际前缀一致，避免双重复写 - 模型层面：所有模型统一加
protected $table = 'xxx';，禁用自动推导；同时删掉protected $name（TP6+ 已废弃，留着反而干扰） - 额外注意：如果用了分库分表中间件或视图，它们的命名不受框架控制，需单独验证是否匹配小写+下划线规则
最常被忽略的一点：表名规范不是为了“好看”，而是为了确保 whereTime()、when()、withAvg() 这类链式方法能正确绑定字段别名。一旦表名不规范，字段映射错位，查出来的数据就可能张冠李戴。
