| 函數 | 計算單位 | UTF-8 漢字 | GBK 漢字 | ASCII 字母/數字 |
|---|---|---|---|---|
LENGTH() | 字節 | 3 | 2 | 1 |
CHAR_LENGTH() / CHARACTER_LENGTH() | 字符 | 1 | 1 | 1 |
SET NAMES utf8mb4;
SELECT
LENGTH('中') AS len_utf8, -- 3
CHAR_LENGTH('中') AS clen_utf8; -- 1
SET NAMES gbk;
SELECT
LENGTH('中') AS len_gbk, -- 2
CHAR_LENGTH('中') AS clen_gbk; -- 1
-- ✅ 正確:按字符數校驗
WHERE CHAR_LENGTH(phone) = 11
-- ❌ 錯誤:UTF-8 下漢字按 3 字節計算
WHERE LENGTH(phone) = 11
-- ✅ 正確:按字節計算存儲佔用
SELECT SUM(LENGTH(content)) FROM articles;
-- ✅ 正確:按字符截取
SELECT LEFT(content, 100) -- 等價 SUBSTRING(content, 1, 100)
-- ❌ 錯誤:按字節截取可能截斷多字節字符產生亂碼
-- SELECT SUBSTRING(content, 1, 100) -- 此處 SUBSTRING 按字符,但 SUBSTRING_BYTES 按字節
CREATE TABLE t (c VARCHAR(10) CHARSET utf8mb4);
-- 可存 10 個漢字(30 字節)或 10 個字母(10 字節)
-- 但最大字節長度受行大小限制 (65535 字節)
-- InnoDB 單列索引最大 767 字節 (innodb_large_prefix=OFF) 或 3072 字節 (ON)
-- UTF-8 下 VARCHAR(255) 索引可能超限 (255*3=765 邊界值)
-- 建議:VARCHAR(191) 或 開啟 innodb_large_prefix + DYNAMIC/COMPRESSED 行格式
String.length() = 字符數(UTF-16 code units)len(str) = 字符數(Unicode code points)len(string) = 字節數CHAR_LENGTH = 字符數,**與應用層多數語言一致**LENGTH() 返回**字節數**(編碼相關),CHAR_LENGTH() 返回**字符數**(編碼無關)。**業務語義上的「長度」永遠用 CHAR_LENGTH**;只有計算磁盤佔用、網絡傳輸、索引長度限制時才用 LENGTH。建立「字符數=業務長度,字節數=物理長度」的認知模型,可避免 90% 的長度計算 Bug。