MySQL表名大小写由操作系统和lower_case_table_names参数共同决定,需在配置文件中设置并重启生效;推荐设为1(小写存储比较),建表与SQL中应统一使用小写字母加下划线命名。

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_item - SQL 语句中对表名、数据库名也统一用小写,不依赖自动转换
- 应用代码(如 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`)—— 只能强制按字面量识别,不改变底层存储或比较逻辑










