• 原因
このリポジトリは以下のモノレポ構成です。

• backend/: Rails
• frontend/: Next.js

リポジトリ直下を通常のフォルダとして開くと、Ruby LSP が backend/.ruby-version を認識できず、グローバルの Ruby 2.7.0 を選んでいました。

Rails が必要とする Ruby は 3.4.1 のため、Ruby LSP が正常起動せず、BackendSchema の定義情報を作れない状態でした。

修正内容
nextjs-rails-graphql-practice.code-workspace を使い、以下を設定しました。

• backend を独立したワークスペースルートとして登録
• frontend も独立したルートとして登録
• Ruby のバージョン管理に rbenv を指定
• Ruby LSP の定義ジャンプを有効化
• 古い Ruby 拡張機能の言語サーバーを無効化
• shopify.ruby-lsp を推奨拡張機能として指定

これにより Ruby LSP が backend/.ruby-version を読み、Ruby 3.4.1 で Rails プロジェクトを解析できるようになりました。

今後の開き方
リポジトリを直接開くのではなく、次のワークスペースファイルを開きます。

code nextjs-rails-graphql-practice.code-workspace

再発時の確認

1. VS Code 左下のワークスペース表示に backend があるか確認
2. コマンドパレットから Ruby LSP: Restart を実行
3. 「出力」パネルで Ruby LSP を選択
4. 以下のような表示を確認

Initializing Ruby LSP
Activating Ruby LSP Rails
Finished booting Ruby LSP Rails server

Ruby 2.7.0 が表示されている場合は、通常のフォルダとして開いている可能性が高いです。Ruby 3.4.1 が選ばれている必要があります。