數據庫字段定義如 VARCHAR(10) 指的是**字節數**而非字符數:
前端限制輸入長度、顯示剩餘字符數、防止入庫截斷報錯,需按目標編碼精確計算。
/**
* 計算字符串在指定編碼下的字節長度
* @param {string} str - 待計算字符串
* @param {'GBK'|'UTF-8'} charset - 目標編碼
* @returns {number} 字節長度
*/
function getByteLength(str, charset) {
if (typeof str !== 'string') str = String(str);
var len = 0;
var isUTF8 = charset === 'UTF-8';
for (var i = 0; i < str.length; i++) {
var code = str.charCodeAt(i);
// ASCII 範圍:0x00-0x7F (0-127) 單字節
if (code >= 0 && code <= 0x7F) {
len += 1;
}
// BMP 非 ASCII 字符
else if (code <= 0xFFFF) {
// GBK:中日韓統一表意文字區塊大部分 2 字節
// UTF-8:3 字節 (1110xxxx 10xxxxxx 10xxxxxx)
len += isUTF8 ? 3 : 2;
}
// 輔助平面字符 (Emoji、罕用字) : UTF-8 4 字節,GBK 無法表示通常替換為 ? (1 或 2 字節)
else {
len += isUTF8 ? 4 : 2; // GBK 這裡按 2 估算或拋錯
}
}
return len;
}
// 測試
console.log(getByteLength('abc', 'GBK')); // 3
console.log(getByteLength('中文', 'GBK')); // 4
console.log(getByteLength('abc', 'UTF-8')); // 3
console.log(getByteLength('中文', 'UTF-8')); // 6
console.log(getByteLength('😀', 'UTF-8')); // 4 (Emoji)
console.log(getByteLength('😀', 'GBK')); // 2 (通常存不進去)
// 現代瀏覽器原生支持 TextEncoder,可精確獲取任意編碼字節長度
async function getExactByteLength(str, encoding = 'utf-8') {
try {
var encoder = new TextEncoder(encoding); // 注意:瀏覽器僅支持 'utf-8'
// GBK 需用第三方庫如 encoding.js 或 iconv-lite (Node.js)
return encoder.encode(str).length;
} catch (e) {
// 降級到估算算法
return getByteLength(str, encoding.toUpperCase());
}
}
// Node.js 環境完美支持 GBK
// const iconv = require('iconv-lite');
// iconv.encode(str, 'gbk').length
注意:瀏覽器端 TextEncoder **僅支持 UTF-8**,GBK 需引入編碼庫(如 encoding-japanese、iconv-lite 的瀏覽器構建版),體積較大,通常前端用估算算法,後端入庫前再精確校驗。
// Vue 3 組件示例
{{ byteLength }} / {{ maxBytes }} 字節
(剩餘 {{ remaining }})
| 字符類型 | Unicode 範圍 | GBK 字節 | UTF-8 字節 | UTF-16 字節 |
|---|---|---|---|---|
| ASCII (英文、數字、常用符號) | U+0000 - U+007F | 1 | 1 | 2 |
| 歐洲文字、希臘、西里爾等 | U+0080 - U+07FF | 2 (部分) | 2 | 2 |
| 中日韓統一表意文字 (常用漢字) | U+4E00 - U+9FFF | 2 | 3 | 2 |
| 擴展漢字、生僻字 | U+20000 - U+2FFFF | 不支持/2* | 4 | 4 (代理對) |
| Emoji (絵文字) | U+1F600 - U+1F64F 等 | 不支持/2* | 4 | 4 (代理對) |
* GBK 無法表示補充平面字符,實際存儲時會報錯或替換為 ? (1 字節) 或 ?? (2 字節)。
前端計算僅為**即時反饋**,**後端必須二次校驗**:
// Java 示例
public boolean checkByteLength(String str, String charset, int maxBytes) {
try {
return str.getBytes(charset).length <= maxBytes;
} catch (UnsupportedEncodingException e) {
return false;
}
}
// MySQL 直接在 SQL 層限制
-- CREATE TABLE t (col VARCHAR(100) CHARACTER SET gbk); -- 100 字節
-- INSERT 時自動報錯:Data too long for column 'col'
前端估算字節長度的核心是「根據 Unicode 碼點範圍映射編碼字節數」。GBK 以 2 字節覆蓋 BMP 中文字符,UTF-8 按 1/2/3/4 字節分級。現代瀏覽器可用 TextEncoder 精確計算 UTF-8,GBK 仍需估算或引入編碼庫。**前端估算 + 後端強校驗** 是穩健的雙重保障體系。