MySQL 表名是否区分大小写,主要由操作系统和 MySQL 的
lower_case_table_names系统变量共同决定,**不能通过建表语句或数据库级设置直接“配置表名规则”**,而是需在 MySQL 启动前配置该参数,并重启服务生效。
查看当前表名大小写行为
执行以下命令,确认当前生效的规则:
SHOW VARIABLES LIKE 'lower_case_table_names';
返回值含义:
0:表名严格区分大小写(Linux 默认,但需文件系统支持) 1:表名转为小写存储和比较(Windows/macOS 默认,最常用) 2:表名按输入保存,但比较时转小写(macOS 兼容模式,不推荐)修改 lower_case_table_names 参数(需重启 MySQL)
该参数是只读变量,必须在 MySQL 配置文件中设置(如
/etc/my.cnf或
/etc/mysql/mysql.conf.d/mysqld.cnf),并在
[mysqld]段落下添加:
[mysqld] lower_case_table_names = 1
⚠️ 注意事项:
修改前确保所有库表名已统一为小写,否则重启后可能无法访问原大写表名的表 Linux 下若设为 0 且文件系统为 ext4(区分大小写),则user和
User是两个不同表;但跨平台迁移时极易出错,生产环境强烈建议设为 1 Windows 和 macOS 文件系统默认不区分大小写,即使设为 0 也实际无效,MySQL 会强制使用 1
避免因大小写引发问题的实践建议
无论系统如何配置,开发者应主动保持一致性:
建表时一律使用小写字母 + 下划线命名,如user_profile、
order_itemSQL 语句中对表名、数据库名也统一用小写,不依赖自动转换 应用代码(如 ORM 配置、DAO 层)中的表名字符串保持小写,避免本地开发(macOS)与线上(Linux)行为不一致 备份恢复前检查
lower_case_table_names值是否匹配,否则
mysql命令行可能报 “Table doesn’t exist”
常见误区澄清
以下操作无法改变表名大小写规则:
执行SET GLOBAL lower_case_table_names = 1—— 会报错,该变量不可动态修改 在 CREATE TABLE 中加 COLLATE 或 CHARSET —— 这只影响字段内容排序,不影响表名解析 用反引号包裹表名(如
`User`)—— 只能强制按字面量识别,不改变底层存储或比较逻辑
