この記事に関連するツール
ブラウザ上ですぐに試せます。記事の内容を確認しながら使うと、作業の流れをつかみやすくなります。
URLの「%E3%81%82」は何を表しているのか
URLを扱っていると、%E3%81%82 や %20 のような記号混じりの文字列を見ることがあります。これはURLエンコードされた文字列です。日本語、空白、記号など、URLの中でそのまま使いにくい文字を安全に送るために変換されています。

DevToolKitsの URLエンコード・デコードツール を使うと、文字列を貼り付けるだけでエンコード前後の形を確認できます。
実例:日本語検索キーワードをURLに入れる
たとえば、検索キーワードとして 東京 駅 カフェ をURLに入れたいとします。空白と日本語をそのまま扱うと、環境によって表示やコピー時に崩れることがあります。
東京 駅 カフェ
URLエンコードすると、次のような文字列になります。
%E6%9D%B1%E4%BA%AC%20%E9%A7%85%20%E3%82%AB%E3%83%95%E3%82%A7
これをクエリパラメータに入れると、共有しやすいURLになります。
https://example.com/search?q=%E6%9D%B1%E4%BA%AC%20%E9%A7%85%20%E3%82%AB%E3%83%95%E3%82%A7
デコードして元の文字列に戻ることまで確認しておくと、検索条件の取り違えや文字化けを見つけやすくなります。
エンコードが必要になる場面
検索キーワード、キャンペーン名、日本語のファイル名、コールバックURLなどをURLに含める場合、文字を正しくエンコードしないとリンクが途中で切れたり、別の値として解釈されたりします。
たとえば hello world の空白は %20 や + として扱われることがあります。APIやフォームによって期待する形式が違うため、実際に送るURLを確認しておくと安心です。
実例:コールバックURLを二重に扱わない
OAuthや外部連携では、URLの中に別のURLを値として入れることがあります。
https://app.example.com/callback?next=/dashboard?tab=billing
このような値を redirect_uri に入れる場合、値として渡すURL部分をエンコードします。
redirect_uri=https%3A%2F%2Fapp.example.com%2Fcallback%3Fnext%3D%2Fdashboard%3Ftab%3Dbilling
ここで注意したいのは、すでにエンコード済みの値をもう一度エンコードしてしまうケースです。% が %25 に変わっていたら二重エンコードの可能性があります。デコード結果を確認し、期待したURLに戻るかを見ると原因を切り分けやすくなります。
クエリ文字列もあわせて確認する
URL全体が長くなると、どのキーにどの値が入っているか分かりにくくなります。UTMやAPIパラメータを確認するときは、URLパラメータJSON変換ツール でキーと値を整理すると、入力ミスや不要なパラメータを見つけやすくなります。
このツールの変換ルール:URL全体ではなく「値」を変換する
このツールの動作は、JavaScript の encodeURIComponent / decodeURIComponent と同じです。実際の変換結果は次のとおりです。
| 入力 | エンコード結果 | ポイント |
|---|---|---|
a b+c |
a%20b%2Bc |
空白は + ではなく %20。+ 自体は %2B になる |
a/b:c@d |
a%2Fb%3Ac%40d |
/ : @ もエンコードされる |
https://example.com/a b?x=1&y=2#top |
https%3A%2F%2Fexample.com%2Fa%20b%3Fx%3D1%26y%3D2%23top |
URL全体を入れると、区切りの : / ? & = # まで変換されて、リンクとして使えなくなる |
it's (ok)! *~-_. |
it's%20(ok)!%20*~-_. |
英数字と ! ' ( ) * ~ - _ . は変換されない |
😀 |
%F0%9F%98%80 |
UTF-8の4バイトが %XX の4つになる |
100% |
100%25 |
% 自体も %25 になる |
したがって、使いどころは「クエリの値」「パスの1区間」「redirect_uri の値」のようなURLの部品です。URL全体ではなく値だけを入れて変換し、?q= の後ろには自分でつなぎます。 「変換の範囲」では、値だけ(encodeURIComponent)のほかに、URL全体(encodeURI。: / ? & = # を残して空白や日本語だけを変換)と、フォーム形式(空白を + にし、デコードでは + を空白に戻す)を選べます。
デコードの挙動も押さえておくと、エラーの原因を切り分けやすくなります。
+は空白に戻りません(a+bはa+bのまま)。フォーム形式の+を空白として読みたいときは、先に+を%20に置き換えてからデコードします%E6%9Dのように途中で切れたUTF-8や、100%のように%の後ろが16進数でないものは、URI malformedのエラーになります。コピーのときに末尾が欠けていないか確認してください%u3042のような旧式の表記はデコードできず、エラーになります
まとめ
URLエンコードは地味ですが、リンク共有、API検証、広告計測でよく事故が起きる部分です。日本語や記号を含むURLを扱うときは、公開前にエンコード結果とパラメータ構造を確認しておくと、あとからの調査がかなり楽になります。
よくある質問
%20 と + はどちらも空白ですか?
どちらも空白を表しますが文脈が違います。URLのパス部分やパーセントエンコードでは空白は %20 になります。一方、クエリ文字列(application/x-www-form-urlencoded)では空白が + で表されることがあります。APIやフォームが期待する形式を確認し、URLエンコード・デコードツールで実際に送る文字列を確かめると安全です。
二重エンコードはどうやって見分けますか?
本来 % は値の一部としては %25 にエンコードされます。デコード結果に %25 や、デコードしても元のURLに戻らない箇所があれば、すでにエンコード済みの値を再度エンコードした「二重エンコード」の可能性が高いです。一度デコードして期待したURLに戻るか確認すると切り分けられます。
日本語を含むURLはエンコードが必須ですか?
ブラウザのアドレスバーでは日本語がそのまま表示されることもありますが、リンクとして共有したりAPIに渡したりする際は、環境による文字化けを避けるためエンコードした形で扱うのが安全です。東京 は %E6%9D%B1%E4%BA%AC のようにUTF-8バイト列としてエンコードされます。
おすすめリソース
このセクションにはアフィリエイトリンクが含まれる場合があります。リンク経由で購入すると、追加費用なしでDevToolKits.appが紹介料を受け取ることがあります。
