萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

Windows 下 MySQL 表名大小寫敏感度配置:lower_case_table_names 參數詳解

Windows 文件系統(NTFS/FAT32)不區分大小寫,導致 MySQL 在 Windows 上預設將表名轉為小寫存儲。若開發環境(Windows)與生產環境(Linux)大小寫策略不一致,會引發「Table doesn't exist」或遷移後 SQL 報錯。本文詳細說明 lower_case_table_names 三種模式、配置方法及跨平台遷移最佳實踐。

參數三種取值對比

Windows 配置步驟

  1. 編輯 my.ini(通常在 C:\ProgramData\MySQL\MySQL Server 5.7\my.ini 或安裝目錄)
  2. 在 [mysqld] 區塊添加:
    lower_case_table_names=2
  3. 重啟 MySQL 服務:net stop mysql && net start mysql 或服務管理器重啟。
  4. 驗證:
    mysql> SHOW VARIABLES LIKE 'lower_case_table_names';
    +------------------------+-------+
    | Variable_name          | Value |
    +------------------------+-------+
    | lower_case_table_names | 2     |
    +------------------------+-------+

遷移血淚教訓與最佳實踐

❌ 典型慘案

  • 開發機 Windows lower_case_table_names=1,建表 User_Info 實際存為 user_info。
  • 代碼寫 SELECT * FROM User_Info,Windows 下能跑。
  • 遷移到 Linux(預設 0),報錯 Table 'db.User_Info' doesn't exist(實際表名 user_info)。

✅ 跨平台統一規範

  1. 代碼規範: 所有 SQL、ORM 實體類、Migration 腳本統一使用小寫+下劃線(snake_case),如 user_info、order_detail。
  2. 配置統一: 開發/測試/生產環境 全部設為 0(Linux 原生),Windows 強制 lower_case_table_names=0 並確保數據目錄在區分大小寫的卷上(NTFS 支援大小寫敏感屬性,需啟用)。
  3. 遷移檢查: 用 pt-table-checksum 或 mysqldump --no-data 對比結構大小寫。

特別提醒

  • 修改參數需重新初始化數據目錄(刪除 datadir 內容、重新 mysqld --initialize),否則舊表文件大小寫不變,導致不一致。
  • InnoDB 系統表空間(ibdata1)也記錄表名大小寫,務必全量重建。
  • 第三方工具備份/還原時注意大小寫保持(mysqldump 預設保留建表語句大小寫)。

表名大小寫敏感度是跨平台部署的隱形殺手。源頭治理:代碼規範統一 snake_case,環境配置統一 0,才能徹底杜絕「在我機器上能跑」的低級故障。

copyright © 萬盛學電腦網 all rights reserved
值行為適用場景
0按建表語句大小寫存儲;查詢區分大小寫Linux 生產環境(預設)
1表名存儲為小寫;查詢轉小寫比較(不區分大小寫)Windows 預設,避免文件系統限制
2按建表大小寫存儲;查詢轉小寫比較Windows 需保留大小寫結構,但查詢不區分大小寫