掌握 Base64 用於前端開發
全面的理解指南 Base64 現代網頁設計中的編碼、解碼和實際應用。
嘗試 Base64 編碼/解碼
到底是什麼 Base64?
Base64 是一種二進製到文本的編碼方案,可將二進制數據(如圖像、文件或原始字節)轉換為 ASCII 字符。這種轉換允許二進制數據安全地傳輸並存儲在專為純文本數據設計的系統中,例如電子郵件協議、HTML 或 API 響應。
“Base64”這個名字來源於它使用 64 個不同的字符(A-Z、a-z、0-9、‘+’和‘/’)來表示二進制值。每個 Base64 字符對 6 位數據進行編碼,使其成為在以文本為中心的環境中處理二進制內容的有效方法。
與加密不同的是, Base64 不是一種安全措施——它純粹是為了數據格式化。任何人都可以使用基本工具解碼 Base64 內容,因此永遠不應該使用它來保護敏感信息。
Base64 字符集
* “=”作為不完整數據的填充字符
怎麼樣 Base64 編碼工作?
-
1
將二進制數據轉換為 8 位字節
該過程從二進制數據(例如圖像文件)開始。該數據被分成 8 位(1 字節)段,形成原始輸入 Base64 編碼。
-
2
將字節分組為 24 位塊
自從 Base64 使用 6 位字符,8 位字節被分組為 24 位(3 字節)塊。 24 位可以平均分為 4 個 6 位段(4 × 6 = 24)。
-
3
將 6 位段轉換為 Base64 字符
每個 6 位段都轉換為十進制值 (0–63)。然後將該值映射到相應的字符 Base64 字符集(例如,0 =“A”、1 =“B”、...、63 =“/”)。
-
4
為不完整的塊添加填充
如果二進制數據長度不是 3 字節的倍數,則最終塊將不完整。 Base64 使用“=”填充字符來指示丟失的字節(1 個“=”表示丟失 1 個字節,2 個“=”表示丟失 2 個字節)。
Base64 編碼示例:文本“Hi!”
| 步 | 輸入數據 | 二進製表示 | Base64 輸出 |
|---|---|---|---|
| 1. 原始文本 | “你好!” | – | – |
| 2. 8 位字節 (ASCII) | H (72),我 (105),! (33) | 01001000, 01101001, 00100001 | – |
| 3. 24位塊 | 72、105、33 | 010010000110100100100001 | – |
| 4. 分成 6 位段 | – | 010010、000110、100100、100001 | – |
| 5. 轉換為十進制 | – | – | 18、6、36、33 |
| 6. 映射到 Base64 字符 | – | – | “皮膚” |
前端 Base64 使用案例
圖像的數據 URL
使用以下命令將小圖像(如圖標或頭像)直接嵌入到 HTML/CSS 中 Base64 數據 URL。這減少了 HTTP 請求並提高了小型資產的頁面加載速度。
<img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." alt="Icon">
API二進制數據傳輸
通過 REST API 傳輸二進制數據(如文件或 PDF),將其編碼為 Base64。這可以避免基於文本的 API 負載(例如 JSON)中的二進制數據損壞問題。
{ "fileData": "JVBERi0xLjQKJeLjz9MNCjYgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlciAvRmxhdGVEZWNvZGU+PgpzdHJlYW0KeAovRjEgMTAgVGYKMDAwLjEwNS4wMDAuMTAwCjAwMC4yOTkuMDAwLjAwMAo...", "fileName": "report.pdf" }
Cookie 和 LocalStorage 文本約束
通過將小型二進制數據編碼為,將其存儲在 cookie 或 LocalStorage(僅支持文本)中 Base64。對於在本地保存用戶首選項或小型資產很有用。
// Save Base64 data to LocalStorage
localStorage.setItem('userAvatar', 'data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA...');
電子郵件附件編碼
大多數電子郵件協議(如 SMTP)都是純文本的。 Base64 用於對電子郵件附件(圖像、文檔)進行編碼,以便它們可以在不損壞的情況下進行傳輸。
Content-Type: image/jpeg; name="photo.jpg"
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="photo.jpg"
/9j/4AAQSkZJRgABAQEAZABkAAD/7QBsUGhvdG9zaG9wIDMuMAA4QklNA+0AAAAAABAASAAAAAEA...
內聯 SVG 編碼
將 SVG 文件編碼為 Base64 用於 CSS 背景或 HTML 屬性中的內聯使用。這簡化了小型矢量圖形的資源管理。
.icon {
background-image: url('data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZD0iTTEyIDJBMTAgMTAgMCAwIDEgMjIgMTJBMTAgMTAgMCAwIDEgMTIgMjJBMTAgMTAgMCAwIDEgMiAxMkExMCAxMCAwIDAgMSAxMiAyWiIgc3Ryb2tlPSIjMTY1REZGIiBzdHJva2Utd2lkdGg9IjIiLz48L3N2Zz4=');
}
畫布圖像導出
HTML5 Canvas API 使用 Base64 將繪製的內容導出為圖像數據(通過 toDataURL())。這可以保存用戶生成的藝術作品或屏幕截圖。
// Get Base64 data from Canvas
const canvas = document.getElementById('myCanvas');
const base64Image = canvas.toDataURL('image/png'); // "data:image/png;base64,iVBORw0KGgo..."
前端 Base64 代碼示例
基本的 Base64 編碼/解碼
使用 JavaScript 的內置 btoa() (二進製到 ASCII)和 atob() (ASCII 到二進制)函數用於簡單 Base64 營運.注意:這些函數適用於 UTF-8 字符串。
// Encode text to Base64
function encodeToBase64(text) {
// Encode UTF-8 to avoid issues with special characters
const utf8Text = unescape(encodeURIComponent(text));
return btoa(utf8Text);
}
// Decode Base64 to text
function decodeFromBase64(base64String) {
const utf8Text = atob(base64String);
return decodeURIComponent(escape(utf8Text));
}
// Example usage
const originalText = "Hello, Base64!";
const encodedText = encodeToBase64(originalText);
const decodedText = decodeFromBase64(encodedText);
console.log("Original:", originalText); // "Hello, Base64!"
console.log("Encoded:", encodedText); // "SGVsbG8sIEJhc2U2NCE="
console.log("Decoded:", decodedText); // "Hello, Base64!"
將圖像編碼為 Base64
將圖像文件(通過文件輸入選擇)轉換為 Base64 使用 FileReader API。對於在上傳或內聯嵌入圖像之前預覽圖像很有用。
// Get elements from DOM
const fileInput = document.getElementById('image-upload');
const previewImage = document.getElementById('image-preview');
const base64Output = document.getElementById('image-base64');
// Handle file selection
fileInput.addEventListener('change', (e) => {
const file = e.target.files[0];
if (!file || !file.type.startsWith('image/')) {
alert('Please select an image file!');
return;
}
// Create FileReader to read the image
const reader = new FileReader();
// On load, get Base64 data
reader.onload = (event) => {
const base64Data = event.target.result;
// Preview the image
previewImage.src = base64Data;
previewImage.style.display = 'block';
// Show Base64 data (truncated for readability)
const truncatedData = base64Data.length > 100
? base64Data.substring(0, 100) + '...'
: base64Data;
base64Output.textContent = truncatedData;
};
// Read the file as Base64
reader.readAsDataURL(file);
});
Base64 數據(截斷):
Base64 到 Blob(下載文件)
轉變 Base64 將數據返回到 Blob(二進制大對象)以在瀏覽器中創建可下載文件(例如 PDF、圖像)。
// Convert Base64 to Blob
function base64ToBlob(base64Data, contentType = 'application/octet-stream') {
// Extract Base64 data (remove "data:..." prefix if present)
const base64WithoutPrefix = base64Data.startsWith('data:')
? base64Data.split(',')[1]
: base64Data;
// Decode Base64 to binary string
const binaryString = atob(base64WithoutPrefix);
const byteLength = binaryString.length;
// Convert binary string to Uint8Array
const uint8Array = new Uint8Array(byteLength);
for (let i = 0; i < byteLength; i++) {
uint8Array[i] = binaryString.charCodeAt(i);
}
// Create and return Blob
return new Blob([uint8Array], { type: contentType });
}
// Trigger file download from Blob
function downloadBlobAsFile(blob, fileName) {
// Create temporary URL for Blob
const url = URL.createObjectURL(blob);
// Create anchor element to trigger download
const a = document.createElement('a');
a.href = url;
a.download = fileName;
// Simulate click to start download
document.body.appendChild(a);
a.click();
// Clean up
document.body.removeChild(a);
URL.revokeObjectURL(url);
}
// Example: Download Base64 PDF
const base64Pdf = "JVBERi0xLjQKJeLjz9MNCjYgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlciAvRmxhdGVEZWNvZGU+PgpzdHJlYW0KeAovRjEgMTAgVGYKMDAwLjEwNS4wMDAuMTAwCjAwMC4yOTkuMDAwLjAwMAo...";
const pdfBlob = base64ToBlob(base64Pdf, 'application/pdf');
downloadBlobAsFile(pdfBlob, 'report.pdf');
Vue.js Base64 成分
可重用的 Vue.js 組件 Base64 編碼/解碼。與 Vue 的反應系統集成以進行實時更新。
<template>
<div class="base64-converter">
<h3 class="text-lg font-semibold mb-4">Vue Base64 Converter</h3>
<!-- Input for text -->
<div class="mb-4">
<label class="block mb-2 text-sm font-medium">Enter Text:</label>
<textarea
v-model="inputText"
class="w-full p-2 border rounded"
rows="3"
placeholder="Type text to encode..."
></textarea>
<button
@click="encode"
class="mt-2 px-4 py-1 bg-primary text-white rounded"
>Encode to Base64</button>
</div>
<!-- Output for Base64 -->
<div class="mb-4">
<label class="block mb-2 text-sm font-medium">Base64 Result:</label>
<textarea
v-model="base64Output"
class="w-full p-2 border rounded"
rows="3"
readonly
></textarea>
<button
@click="decode"
class="mt-2 px-4 py-1 bg-secondary text-white rounded"
>Decode to Text</button>
</div>
</div>
</template>
<script>
export default {
data() {
return {
inputText: '',
base64Output: ''
};
},
methods: {
encode() {
if (!this.inputText) return;
// Encode UTF-8 text to Base64
const utf8Text = unescape(encodeURIComponent(this.inputText));
this.base64Output = btoa(utf8Text);
},
decode() {
if (!this.base64Output) return;
// Decode Base64 to UTF-8 text
const utf8Text = atob(this.base64Output);
this.inputText = decodeURIComponent(escape(utf8Text));
}
}
};
</script>