URL やファイル名に日本語は使えますか

使用は可能ですが推奨しておりません。

なぜ推奨しないのか

URL やファイル名に日本語(マルチバイト文字)を使用した場合、以下の問題が発生する可能性があります。

  • ジェネレート時のエラー:静的ファイルの生成処理で日本語を含むパスの解決に失敗し、該当ページが 404 になる場合があります
  • ブラウザ・ツールによる表示の差異:日本語 URL はパーセントエンコード(例:%E6%97%A5%E6%9C%AC%E8%AA%9E)に変換されるため、SNS やメールで共有した際に可読性が低下します
  • 外部サービスとの連携問題:Analytics や検索エンジンクローラーによっては、エンコードされた URL を正しく処理できない場合があります
  • 画像・メディアファイル:日本語ファイル名でアップロードした画像は、ページ生成時に正しく参照されないことがあります

問題が発生した場合の対処

ジェネレートエラーやアクセス時に 404 が発生した場合は、以下の手順で対処してください。

記事・ページの URL(パーマリンク)の場合

  1. WordPress 管理画面で該当の記事・ページを開く
  2. パーマリンクを半角英数字に変更して保存する
  3. 再度ジェネレートを実行する

画像・メディアファイルの場合

  1. 該当ファイルをメディアライブラリから削除する
  2. ファイル名を半角英数字・ハイフン・アンダースコアのみに変更してから再アップロードする
  3. 記事内の参照先を新しい URL に更新した上でジェネレートを実行する

推奨する命名規則

項目推奨非推奨
記事スラッグmy-article-title私の記事タイトル
画像ファイル名product-image-01.jpg商品画像01.jpg
カテゴリスラッグnewsニュース