JetBrains Rider 2024.1 ヘルプ

Vite

JetBrains Rider は、フロントエンド開発エクスペリエンスを向上させる Vite(英語) ビルドツールと統合されています。Vite は、開発サーバーとビルドコマンドで構成されます。ビルドサーバーは、ネイティブ ES モジュールを介してソースファイルを提供します。build コマンドはコードを Rollup にバンドルします。Rollup は、本番用に高度に最適化された静的アセットを出力するように事前構成されています。

JetBrains Rider は、Vue style タグで tsconfig.json および jsconfig.json パスマッピングをサポートし、Vite エイリアス(英語)を認識します。

異なる Vite 構成を持つ複数のモジュールで構成されるプロジェクトでは、JetBrains Rider は各モジュールに関連する構成ファイルを自動的に検出し、そこからモジュール解決ルールを使用できます。以下の使用する Vite 構成ファイルの指定を参照してください。

始める前に

  1. Node.js をダウンロードしてインストールします。

  2. 設定で JavaScript と TypeScript プラグインが有効になっていることを確認します。Ctrl+Alt+S を押して設定を開き、プラグインを選択します。インストール済みタブをクリックします。検索フィールドに JavaScript と TypeScript と入力します。プラグインの詳細については、プラグインのマッピングを参照してください。

  3. JetBrains マーケットプレイスからプラグインをインストールする説明に従って、設定 / 環境設定 | プラグインページのマーケットプレースタブに Vite プラグインをインストールして有効にします。

新しい Vite アプリケーションを作成する

Vite を既存のソリューションまたは空のソリューションにインストールする

Vite オフィシャル Web サイト(英語)からプロジェクトに Vite を追加する方法について詳しくは、こちらを参照してください。

空の JetBrains Rider ソリューションを作成する

  1. ウェルカム画面で新規ソリューションをクリックするか、メインメニューからファイル | 新規ソリューションを選択します。新規ソリューションダイアログが開きます。

  2. 左側のペインで、空のソリューションを選択します。右側のウィンドウで、アプリケーションフォルダーを指定し、作成をクリックします。

空のソリューションに Vite をインストールする

  1. Vite を使用する空のソリューションを開きます。

  2. 埋め込まれたターミナルAlt+F12)で、次のように入力します。

    npm install --save-dev vite

既存の Vite アプリケーションから始めます

既存の Vite アプリケーションの開発を継続するには、JetBrains Rider で開き、必要な依存関係をダウンロードします。

すでにマシン上にあるアプリケーションソースを開く

  • ウェルカム画面で開くをクリックするか、メインメニューからファイル | 開く | 開くを選択します。開いたダイアログで、ソースが保存されているフォルダーを選択します。

バージョン管理からアプリケーションのソースをチェックアウト

  1. ウェルカム画面で VCS から取得をクリックします。

    または、メインメニューから Git | クローン…または VCS | バージョン管理から取得を選択します。

    メインメニューの Git の代わりに、プロジェクトに関連付けられている他のバージョン管理システムが表示される場合があります。例: Mercurial または Perforce

  2. 表示されるダイアログで、リストからバージョン管理システムを選択し、アプリケーションソースをチェックアウトするリポジトリを指定します。詳細については、プロジェクトをチェックアウトする (クローン) を参照してください。

依存関係をダウンロードする

  • ポップアップで 'npm install' の実行または実行 'yarn install' をクリックします。

    Open an application and download the dependencies

    npm(英語)Yarn 1(英語)、または Yarn 2(英語) を使用できます。詳細については、npm および Yarn を参照してください。

  • あるいは、エディターまたはプロジェクトツールウィンドウの package.json のコンテキストメニューから 'npm install' の実行または実行 'yarn install' を選択します。

プロジェクトのセキュリティ

JetBrains Rider の外部で作成され、そこにインポートされたプロジェクトを開くと、JetBrains Rider は、未知ソースコードを使用してこのプロジェクトを処理する方法を決定できるダイアログを表示します。

次のいずれかのオプションを選択します。

  • セーフモードでプレビュー : この場合、JetBrains Rider はプロジェクトをプレビューモードで開きます。これは、プロジェクトのソースを参照することはできますが、タスクやスクリプトを実行したり、プロジェクトを実行 / デバッグしたりすることはできないことを意味します。

    JetBrains Rider はエディター領域の上部に通知を表示し、プロジェクトを信頼…リンクをクリックして、いつでもプロジェクトをロードできます。

  • プロジェクトを信頼 : この場合、JetBrains Rider はプロジェクトを開いてロードします。これは、プロジェクトが初期化され、プロジェクトのプラグインが解決され、依存関係が追加され、すべての JetBrains Rider 機能が使用可能になることを意味します。

  • 開かない : この場合、JetBrains Rider はプロジェクトを開きません。

JetBrains Rider で Vite を構成する

Vite 構成ファイルを作成する

  • プロジェクト構造に応じて、1 つまたは複数の構成ファイルを作成します。プロジェクトツールウィンドウで親フォルダーを選択し、コンテキストメニューから新規 | JavaScript ファイルを選択します。

    Create a Vite configuration file

    受け入れ可能な名前は vite.config.js / vite.config.tsvite.config.mjs または vite.config.cjs です。

    Vite オフィシャル Web サイト(英語)の詳細を参照してください。

  • 必要に応じて、後で import ステートメントで認識される alias を使用します。エイリアスの定義では必ず絶対パスを指定してください。Vite オフィシャル Web サイト(英語)から詳細を参照してください。

    Completing alias in import statements

使用する Vite 構成ファイルを指定する

Vite 構成ファイルの分析に基づいて、JetBrains Rider は Vite 構成を理解し、モジュールを解決し、JavaScript および TypeScript ファイルのコーディング支援を提供します。

JetBrains Rider では、自動と手動の 2 つの構成モードから選択できます。

自動構成では、JetBrains Rider は各 JavaScript または TypeScript ファイルに関連する Vite 構成ファイルを自動検出します。

手動構成では、プロジェクトで使用する Vite 構成ファイルを指定します。Vite 構成ファイルの名前が JetBrains Rider で認識されない場合は、手動構成が便利です。以下の認識される Vite 構成名のリストを参照してください。

Vite 構成を検出する方法を選択する

  1. 設定 / 環境設定ダイアログ(Ctrl+Alt+S)を開き、言語 & フレームワーク | JavaScript | Vite に移動します。

  2. モジュール解決のための Vite 構成ファイルの検出領域で、次のいずれかのオプションを選択します。

    • 自動 : このモードでは、JavaScript または TypeScript ファイルの場合、JetBrains Rider は最初にこの JavaScript または TypeScript ファイルが配置されているフォルダーで Vite 構成ファイルを探し、次にその親フォルダーで探します。

      その結果、プロジェクトが異なる Vite 構成の複数のモジュールで構成されている場合、各モジュールは独自の Vite 構成ファイルのモジュール解決ルールを使用します(そのような構成が見つかった場合)。

      JetBrains Rider は、次の名前の JavaScript または TypeScript Vite 構成ファイルを次の順序で認識します。

      • vite.config.js / vite.config.ts

      • vite.config.mjs

      • vite.config.cjs

    • 手動 : 構成ファイルフィールドで、使用する Vite 構成の場所を指定します。

      このモードでは、指定された構成ファイルの解決ルールがプロジェクト内のすべてのモジュールに適用されます。

      Vite 構成ファイルの名前が JetBrains Rider で認識されない場合は、このオプションを選択します。上記の認識される Vite 構成名のリストを参照してください。

      Select a vite configuration file manually

Vite アプリケーションを実行する

  1. package.jsondev スクリプトの横にあるガターで the Run icon をクリックするか、ターミナル Alt+F12npm run dev を実行するか、npm ツールウィンドウ ( 表示 | ツールウィンドウ | npm) で dev タスクをダブルクリックします。

    Run a Vite app in the development mode from package.json
  2. アプリケーションがコンパイルされ、開発サーバーの準備ができるまで待ちます。

    実行ツールウィンドウまたはターミナルには、アプリケーションが実行されている URL が表示されます。アプリケーションが create-vue で生成された場合、デフォルトの URL は http://localhost:5173/ です。このリンクをクリックすると、アプリケーションが表示されます。

    Vue.js app is running in the development mode

実行 / デバッグ構成を介して Vite アプリケーションを実行する

create-vite で作成されたアプリケーションの場合、JetBrains Rider は npm 構成を生成します。この構成は、開発サーバーを起動し、開発モードでアプリケーションを起動する vite コマンドを実行します。

それ以外の場合は、ホスト、ポートなどの実際の設定を手動で実行 / デバッグ構成を作成するする必要があります。

npm 実行 / デバッグ構成を作成する

  1. 実行 | 実行構成の編集に進みます。あるいは、ツールバーのリストから実行構成の編集を選択します。

    Open the Edit Configurations dialog

    開いた実行構成の編集ダイアログで、ツールバーの追加ボタン (the Add button) をクリックし、リストから npm を選択します。

  2. 開いた実行 / デバッグ構成: npm ダイアログの構成タブで、使用する package.json の場所、Node.js インタープリター、およびパッケージマネージャーを指定します。

    コマンドフィールドで、リストから実行を選択し、次にスクリプトリストから実行するスクリプトを選択します。ほとんどの場合、デフォルトの dev スクリプトになりますが、カスタムポートでアプリケーションを実行するなど、package.json で別のスクリプトを構成することもできます。

    npm run/debug configuration
  3. オプション:

    ブラウザーでアプリケーションを開くには、次のように構成を更新します。ブラウザー / Live Edit タブで、起動後チェックボックスをオンにし、アプリケーションを開くブラウザーを選択して、アプリケーションが実行される URL アドレスを指定します。

    アプリケーションをデバッグする場合は、Google Chrome(英語) または別の Chromium ベースのブラウザー(英語)を選択します。

    Browser / Live Edit tab: select browser

アプリケーションの実行

  1. ツールバーのリストから npm dev 実行構成を選択し、その横にある Run をクリックします。

    Run a Vite app in the development mode via a run/debug configuration
  2. アプリケーションがコンパイルされ、開発サーバーの準備ができるまで待ちます。

    実行ツールウィンドウまたはターミナルには、アプリケーションが実行されている URL が表示されます。このリンクをクリックすると、アプリケーションが表示されます。

    Running Vite app: the Development server is ready

    または、上記のように、 JetBrains Rider が起動時にアプリケーションを開くようにします。

Vite アプリケーションをデバッグする

デバッグセッションは、実行 / デバッグ構成を起動するから開始することも、開発モードでアプリケーションが実行されている URL を表示する実行ツールウィンドウから開始することもできます。

実行 / デバッグ構成を介してデバッグを開始する

Vite アプリケーションをデバッグするには、2 つの実行 / デバッグ構成が必要です。

  • 上記のように、開発モードでアプリケーションを起動するための npm 構成。

  • 開発モードで実行されているアプリケーションにデバッガーを接続するための JavaScript デバッグ構成。

npm 実行 / デバッグ構成を使用して Vite アプリケーションを実行およびデバッグするに従って、npm 構成内に JavaScript デバッグ構成を作成して、一度に起動することができます。

または、JavaScript デバッグ実行 / デバッグ構成でデバッグを開始するに従って、npmJavaScript デバッグの実行 / デバッグ構成を個別に作成して起動します。

単一の npm 実行 / デバッグ構成で Vite アプリケーションを実行およびデバッグする

  1. コードにブレークポイントを設定します。

  2. 上記の説明に従って npm 構成を作成します。

    create-vite を使用してアプリケーションを生成した場合、JetBrains Rider はデフォルト名 npm devnpm 構成をすでに作成しています。構成は、実行ウィジェットおよび実行 / デバッグ構成ダイアログで利用できます。

    Autogenerated npm run/debug configuration
  3. 開いた実行 / デバッグ構成: npm ダイアログの構成タブで、使用する package.json の場所、Node.js インタープリター、およびパッケージマネージャーを指定します。

    コマンドフィールドで、リストから実行を選択し、次にスクリプトリストから実行するスクリプトを選択します。ほとんどの場合、デフォルトの dev スクリプトになりますが、カスタムポートでアプリケーションを実行するなど、package.json で別のスクリプトを構成することもできます。

    npm run/debug configuration
  4. ブラウザー / Live Edit タブで、起動後チェックボックスを選択し、リストから Google Chrome(英語) または別の Chromium ベースのブラウザー(英語)を選択し、JavaScript デバッガーを使用するチェックボックスを選択して、アプリケーションを実行する URL を指定します。

    npm configuration, Browser tab
  5. 実行をクリックします。

    構成を再実行するには、実行ウィジェットのリストから構成を選択し、その横にある Run をクリックします。

    JetBrains Rider はアプリケーションを開発モードで実行し、同時にデバッグセッションを起動します。

    Debugging session
  6. 最初のブレークポイントに到達したら、デバッグウィンドウに切り替えて通常どおり続行します。プログラムをステップ実行し、プログラムの実行を停止して再開し、中断したときにそれを調べ、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、実際の HTML DOM を表示します

JavaScript デバッグ実行 / デバッグ構成でデバッグを開始する

  1. コードにブレークポイントを設定します。

  2. 上記のように開発モードでアプリケーションを起動し、アプリケーションがコンパイルされて開発サーバーの準備ができるまで待ちます。

    実行ツールウィンドウまたはターミナルには、アプリケーションが実行されている URL が表示されます。この URL をコピーして、後で JavaScript デバッグ構成で指定します

    Application is running in the development mode
  3. JavaScript デバッグ構成を作成します。これを行うには、メインメニューの実行 | 実行構成の編集に移動し、the Add icon をクリックして、リストから JavaScript デバッグを選択します。

  4. 開いた実行 / デバッグ構成: JavaScript デバッグダイアログで、構成の名前と、開発モードでアプリケーションが実行されている URL アドレスを指定します。この URL は、上記のように、実行ツールウィンドウまたはターミナルにコピーできます。

    Create a JavaScript Debug configuration: specify the URL
  5. デバッグをクリックします。

    構成を再実行するには、実行ウィジェットのリストから構成を選択し、その横にある Debug をクリックします。

    Run a JavaScript Debug configuration from the Run widget
  6. 最初のブレークポイントに到達したら、デバッグウィンドウに切り替えて通常どおり続行します。プログラムをステップ実行し、プログラムの実行を停止して再開し、中断したときにそれを調べ、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、実際の HTML DOM を表示します

実行ツールウィンドウまたは組み込みのターミナルからデバッグを開始する

アプリケーションが localhost の開発モードで実行されている場合、特に create-vite で生成された場合は、> 実行ツールウィンドウまたは組み込みのターミナルから直接デバッグセッションを開始できます。

  1. コードにブレークポイントを設定します。

  2. 上記のように開発モードでアプリケーションを起動し、アプリケーションがコンパイルされて開発サーバーの準備ができるまで待ちます。

  3. 実行ツールウィンドウまたはターミナルには、アプリケーションが実行されている URL が表示されます。Ctrl+Shift を押したまま、この URL リンクをクリックします。JetBrains Rider は、タイプ JavaScript デバッグの自動生成された 構成でデバッグセッションを開始します。

    Starting a debugging session from the Run tool window, the application is running on localhost

最初のブレークポイントに到達したら、デバッグウィンドウに切り替えて通常どおり続行します。プログラムをステップ実行し、プログラムの実行を停止して再開し、中断したときにそれを調べ、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、実際の HTML DOM を表示します

Node.js 17 以降のトラブルシューティング

Node.js バージョン 17 以降を使用している場合、デバッグセッション中にネットワーク接続の問題が発生し、デバッガーの接続やソースマップのロードで問題が発生する可能性があります。

回避策は、--host 127.0.0.1 をサーバーに渡すことです。これは、次のいずれかの方法で行うことができます。

  • package.jsondev スクリプトを更新します。

    "dev": "vite --host=127.0.0.1"
  • あるいは、dns.setDefaultResultOrder('ipv4first')vite.config.ts に追加します。

関連ページ:

プラグインのインストール

プラグインは JetBrains Rider のコア機能を拡張します。例: プラグインをインストールして、次の機能を取得します。バージョン管理システム、課題追跡システム、ビルド管理サーバー、その他のツールとの統合。さまざまな言語とフレームワークのコーディング支援サポート。ショートカットのヒント、ライブプレビュー、ファイルウォッチャーなど。新しいプログラミング言語を学ぶのに役立つコーディング演習。プラグイン設定を開くを押して設定を開き、を選択します。マーケットプレースタブを使用して、JetBrai...

GitHub でホストされているプロジェクトを管理する

解決策を確認する (クローン):貢献したいリポジトリを JetBrains Rider から直接複製し、それに基づいて新しいソリューションを作成できます。メインメニューで、に移動します。Git メニューが使用できない場合は、を選択します。バージョン管理から取得ダイアログで、左側の GitHub を選択します。次のいずれかを実行して、GitHub にログインします。トークンがある場合は、トークンを使用するをクリックし、トークンをトークンフィールドに貼り付けて、ログインをクリックします。それ以外の場合は、...

npm、pnpm、Yarn

JetBrains Rider は npm、pnpm、Yarn、Yarn 2、Yarn 3 と統合されているため、組み込みのターミナルで IDE 内から再利用可能なコードのパッケージをインストール、検索、更新、削除できます。JetBrains Rider では、npm、Yarn、pnpm スクリプトを実行およびデバッグすることもできます。JetBrains Rider は、package.json ファイルを解析してスクリプトの定義を認識し、スクリプトをツリービューに表示して、ツリー内のスクリプトと...

実行 / デバッグ構成: NPM

作成: このダイアログでは、npm および Yarn スクリプトをローカルで実行するための構成を作成します。現在のコンテキストにおける「ローカル」とは、JetBrains Rider 自体がコンピューターにインストールされている Node.js を起動し、その後スクリプトの実行を開始することを意味します。スクリプトが開発モードでアプリケーションを起動する場合、構成を変更してデバッグセッションも開始することができます。これを行うには、ブラウザー / ライブ編集タブに移動し、アプリケーションが実行される URL...

ブレークポイント

ブレークポイントを使用すると、特定のステートメントでプログラムの実行を一時停止し、変数値、コールスタック、その他のプログラムパラメーターを分析したり、式を評価したり、プログラムをステップ実行したりできます。JetBrains Rider では、次の型のブレークポイントを操作できます。行ブレークポイント、コード内の特定の文に設定できます。実行がこの行に達すると、デバッガーはプログラムの実行を中断します。行ブレークポイントは実行可能な行にのみ設定できます。コメント、宣言、空行は、行ブレークポイントの...

デバッグウィンドウ

デバッガーセッションを開始すると、デバッグツールウィンドウが表示されます。このウィンドウを使用して、デバッガーセッションを制御し、プログラムデータ(フレーム、スレッド、変数など)を表示して分析し、さまざまなデバッガーアクションを実行します。これは、デバッグツールウィンドウの概要です。ツールウィンドウの使用に関する一般的な手順については、ツールウィンドウを参照してください。ツールウィンドウのタブを切り替えるには、とを押します。セッション:複数のデバッグセッションを同時に実行すると、それらはデ