Base64 與 UTF-8 是前端開發中常見的編碼方式,常用於資料傳輸、避免特殊字元出問題等場景。本文完整說明 Base64 的編碼原理,並提供可直接使用的 Base64 與 UTF-8 編碼解碼函式。
Base64 的規則是:把 3 個 8-bit 位元組(共 24 bits)轉換為 4 個 6-bit 位元組(4×6=24 bits),再在每个 6-bit 前補兩個 0,湊成 8-bit 一組。若剩下的字元不足 3 個位元組,則以 0 填補,輸出時用 '=' 補齊,因此編碼後的結果結尾可能會出現 1 或 2 個 '='。
以下提供一個完整的 base64 模組,特別處理了中文字元(透過 Unicode 與 ANSI 編碼轉換),並封裝為 encode64 與 decode64 兩個方法。由於中文字元對照表極為龐大,此處僅呈現其骨架與關鍵邏輯:
var base64 = (function(){
var keyStr = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=";
return { "encode64": encode64, "decode64": decode64 };
function encode64(input) {
input = strUnicode2Ansi(input); // 先把 Unicode 轉為 ANSI 位元組
var output = "", chr1, chr2, chr3, enc1, enc2, enc3, enc4, i = 0;
do {
chr1 = input.charCodeAt(i++);
chr2 = input.charCodeAt(i++);
chr3 = input.charCodeAt(i++);
enc1 = chr1 >> 2;
enc2 = ((chr1 & 3) << 4) | (chr2 >> 4);
enc3 = ((chr2 & 15) << 2) | (chr3 >> 6);
enc4 = chr3 & 63;
if (isNaN(chr2)) { enc3 = enc4 = 64; }
else if (isNaN(chr3)) { enc4 = 64; }
output += keyStr.charAt(enc1) + keyStr.charAt(enc2) +
keyStr.charAt(enc3) + keyStr.charAt(enc4);
chr1 = chr2 = chr3 = enc1 = enc2 = enc3 = enc4 = "";
} while (i < input.length);
return output;
}
function decode64(input) {
var output = "", chr1, chr2, chr3, enc1, enc2, enc3, enc4, i = 0;
if (input.length % 4 != 0) return "";
var base64test = /[^A-Za-z0-9+/=]/g;
if (base64test.exec(input)) return "";
do {
enc1 = keyStr.indexOf(input.charAt(i++));
enc2 = keyStr.indexOf(input.charAt(i++));
enc3 = keyStr.indexOf(input.charAt(i++));
enc4 = keyStr.indexOf(input.charAt(i++));
chr1 = (enc1 << 2) | (enc2 >> 4);
chr2 = ((enc2 & 15) << 4) | (enc3 >> 2);
chr3 = ((enc3 & 3) << 6) | enc4;
output += String.fromCharCode(chr1);
if (enc3 != 64) output += String.fromCharCode(chr2);
if (enc4 != 64) output += String.fromCharCode(chr3);
chr1 = chr2 = chr3 = enc1 = enc2 = enc3 = enc4 = "";
} while (i < input.length);
return strAnsi2Unicode(output); // 再轉回 Unicode
}
// strUnicode2Ansi / strAnsi2Unicode / UnicodeChr / AnsicodeChr 為中文字元對照轉換,此處省略
}());
// 測試
var str = base64.encode64("這是測試");
alert(base64.decode64(str));
下面這套是另一常見實作,透過 base64EncodeChars 與 base64DecodeChars 兩個對照表,以位元運算完成編解碼,並搭配 utf16to8 與 utf8to16 處理 Unicode:
var base64EncodeChars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
var base64DecodeChars = new Array(
-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,
-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,
-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,62,-1,-1,-1,63,
52,53,54,55,56,57,58,59,60,61,-1,-1,-1,-1,-1,-1,
-1,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,
15,16,17,18,19,20,21,22,23,24,25,-1,-1,-1,-1,-1,
-1,26,27,28,29,30,31,32,33,34,35,36,37,38,39,40,
41,42,43,44,45,46,47,48,49,50,51,-1,-1,-1,-1,-1
);
function base64encode(str){
var out, i, len, c1, c2, c3;
len = str.length; i = 0; out = "";
while (i < len) {
c1 = str.charCodeAt(i++) & 0xff;
if (i == len) {
out += base64EncodeChars.charAt(c1 >> 2);
out += base64EncodeChars.charAt((c1 & 0x3) << 4);
out += "==";
break;
}
c2 = str.charCodeAt(i++);
if (i == len) {
out += base64EncodeChars.charAt(c1 >> 2);
out += base64EncodeChars.charAt(((c1 & 0x3) << 4) | ((c2 & 0xF0) >> 4));
out += base64EncodeChars.charAt((c2 & 0xF) << 2);
out += "=";
break;
}
c3 = str.charCodeAt(i++);
out += base64EncodeChars.charAt(c1 >> 2);
out += base64EncodeChars.charAt(((c1 & 0x3) << 4) | ((c2 & 0xF0) >> 4));
out += base64EncodeChars.charAt(((c2 & 0xF) << 2) | ((c3 & 0xC0) >> 6));
out += base64EncodeChars.charAt(c3 & 0x3F);
}
return out;
}
// base64decode、utf16to8、utf8to16 依相同位元原理實作,此處省略
若要把字串轉成 \uXXXX 形式的 UTF-8 轉義序列,可用下面的簡便寫法:
function encodeUTF8(str){
var temp = "", rs = "";
for (var i = 0, len = str.length; i < len; i++){
temp = str.charCodeAt(i).toString(16);
rs += "u" + new Array(5 - temp.length).join("0") + temp;
}
return rs;
}
function decodeUTF8(str){
return str.replace(/(u)(w{4}|w{2})/gi, function($0, $1, $2){
return String.fromCharCode(parseInt($2, 16));
});
}
以上就是 JavaScript 中 Base64 與 UTF-8 編碼解碼的完整整理。由於原文的中文字元對照表長達數千組,這裡以骨架呈現核心邏輯;實際使用時,直接採用已驗證的第一套 base64 模組即可穩定處理中文。熟用它們,就能在跨系統資料傳遞與編碼轉換上游刃有餘。