【Rails】deviseのエラーメッセージを日本語化する方法

deviseを使用したアプリケーションで、ログインや新規登録のエラーメッセージを日本語化することで、ユーザーにとってより使いやすいインターフェースを提供できます。今回は、deviseのエラーメッセージを日本語に変更する設定方法について解説します。

1. devise-i18nを導入する

devise-i18nというGemを使用することで、deviseのエラーメッセージを簡単に多言語化できます。このGemには日本語を含む多くの言語ファイルが含まれており、すぐに設定に使用できます。

Gemをインストールする

gem

gem 'devise-i18n'

を追加します。

bundle install

2. Railsの日本語化設定を行う

次に、Rails全体の言語設定を日本語に変更します。config/application.rbファイルを開き、以下の行を追加または編集します。

config/application.rb

module YourApp
  class Application < Rails::Application
    # 以下の行を追加
    config.i18n.default_locale = :ja
  end
end

これにより、Rails全体のデフォルト言語が日本語に設定され、deviseを含むシステム全体のメッセージが日本語で表示されるようになります。

3. 日本語化ファイルを確認する

devise-i18nのGemをインストールした後、deviseの日本語の翻訳ファイルが自動的に適用されますが、必要に応じてカスタマイズできます。翻訳ファイルは以下のパスにインストールされます。
• config/locales/devise.ja.yml

このファイルを編集すると、エラーメッセージやその他のメッセージの日本語表記をカスタマイズできます。

4. config/locales/ja.ymlでRails全体の日本語化を設定する（オプション）

もし、まだRails全体の日本語設定をしていない場合、ja.ymlファイルを追加して日本語化設定を行います。config/locales/ja.ymlファイルを作成し、以下のように記述します。

ja:
  hello: "こんにちは"
  activerecord:
    errors:
      messages:
        record_invalid: "入力にエラーがあります"
  devise:
    sessions:
      user:
        signed_in: "ログインしました。"
        signed_out: "ログアウトしました。"
    registrations:
      user:
        signed_up: "アカウント登録が完了しました。"
        updated: "アカウント情報を更新しました。"

このファイルでdeviseの特定のメッセージや、Rails全体のメッセージを自由にカスタマイズできます。

まとめ

Gemfileにdevise-i18nを追加してbundle installでインストール
config/application.rbでconfig.i18n.default_locale = :jaを設定
必要に応じてconfig/locales/devise.ja.ymlの日本語化ファイルをカスタマイズ
config/locales/ja.ymlを作成し、Rails全体のメッセージを日本語化（オプション）