Base64とは
Base64 は、画像や日本語などのバイナリデータを A–Z a–z 0–9 + / の64種類の文字(+パディングの =)だけで表現するエンコード方式です。テキストしか扱えない場所でデータを安全にやり取りするために使われます。
- メールの添付ファイル(MIME)
- HTML / CSS への画像の埋め込み(
data:image/png;base64,...) - Basic 認証ヘッダー(
Authorization: Basic ...) - JWT(JSON Web Token)の各パート(URL-safe Base64)
使い方
- テキストを変換する場合は入力欄に貼り付けて「エンコード」または「デコード」を押します。
- 画像などのファイルを変換する場合は「ファイルを選択」からファイルを選ぶと、結果欄にBase64が表示されます。
- Base64からファイルに戻したい場合は、入力欄にBase64を貼り付けて「入力のBase64をファイルとして保存」を押します。
URL-safe Base64 とは
通常のBase64で使う + と / はURLの中で特別な意味を持つため、それぞれ - と _ に置き換えた形式です。末尾の = も省略されることが多く、JWT などで使われています。デコード時はどちらの形式も自動で判別します。
サイズは約1.33倍になる
Base64 は3バイトを4文字で表すため、変換後のサイズは元データの約 4/3 倍になります。大きな画像を data URI で埋め込むとHTMLが重くなるので、アイコンなど小さな画像に使うのがおすすめです。
Base64 の仕組み(3バイトが4文字になる)
Base64 は、データを3バイト(24ビット)ずつ区切り、6ビットずつ4つに分けて、64種類の文字(A-Z a-z 0-9 + /)に置き換えます。3バイトに満たない端数は = で埋めます(パディング)。
| 入力 | Base64 | メモ |
|---|---|---|
Man | TWFu | 3バイトちょうど → 4文字 |
Ma | TWE= | 2バイト → 末尾に = が1つ |
M | TQ== | 1バイト → 末尾に = が2つ |
日本語(UTF-8 の9バイト) | 5pel5pys6Kqe | 12文字になる |
各言語・コマンドでBase64を使う
| 環境 | エンコード | デコード |
|---|---|---|
| ブラウザの JavaScript | btoa(str)(日本語は下の方法が必要) | atob(b64) |
| Node.js | Buffer.from(s).toString('base64') | Buffer.from(b64, 'base64').toString() |
| Python | base64.b64encode(s.encode()).decode() | base64.b64decode(b64).decode() |
| PHP | base64_encode($s) | base64_decode($b64) |
| Java | Base64.getEncoder().encodeToString(bytes) | Base64.getDecoder().decode(b64) |
| Go | base64.StdEncoding.EncodeToString(b) | base64.StdEncoding.DecodeString(b64) |
| Linux のコマンド | echo -n 'abc' | base64 | echo 'YWJj' | base64 -d |
JavaScript の btoa で日本語がエラーになる
ブラウザの btoa('あ') は、InvalidCharacterError(Latin1 の範囲外の文字が含まれている)で失敗します。btoa は1文字1バイトの文字列しか扱えないためです。日本語は、いったん UTF-8 のバイト列にしてから変換します。
エンコード: btoa(String.fromCharCode(...new TextEncoder().encode('日本語'))) → 5pel5pys6Kqe
デコード: new TextDecoder().decode(Uint8Array.from(atob('5pel5pys6Kqe'), c => c.charCodeAt(0))) → 日本語
Base64 が使われる場面
- 画像の埋め込み:
data:image/png;base64,...の形(データURI)で、HTML や CSS に画像を直接書く。 - メール: 添付ファイルや、日本語の件名(
=?UTF-8?B?...?=)を送る MIME の形式。 - JWT: ヘッダーとペイロードに Base64URL を使う。JWTデコーダーで中身を確認できる。
- HTTP Basic 認証:
ユーザー名:パスワードを Base64 にして送る(user:passはdXNlcjpwYXNz)。暗号化ではないので、必ず HTTPS で使う。 - API: JSON の中にバイナリデータ(画像・ファイル)を入れる。
よくある質問
Base64は暗号化ですか?
いいえ。Base64は誰でも元に戻せる変換で、暗号化ではありません。パスワードや個人情報の保護には使えません。
デコードすると「テキストとして解釈できません」と出ます
元のデータが画像などのバイナリか、別の文字コードのテキストです。文字コードを切り替えるか、「入力のBase64をファイルとして保存」でファイルとして取り出してください。
ファイルはアップロードされますか?
いいえ。ファイルの読み込みと変換はブラウザ内で完結し、サーバーには送信されません。
デコードした結果が文字化けします
元のテキストの文字コードと、デコード時に選んだ文字コードが違う可能性があります。UTF-8 と Shift_JIS を切り替えて確認してください。それでも化ける場合は 文字化け復元 に貼り付けると、化けた原因を自動で探せます。
Base64 の途中に改行が入っています
メール(MIME)の Base64 は、76文字ごとに改行を入れる決まりです。デコードするときは改行が入っていても問題なく読めます。