PhpStorm 2025.1 ヘルプ

Next.js

PhpStorm は、Next.js(英語) React フレームワークと統合されています。

始める前に

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

  2. 設定 | プラグインページのインストール済みタブで、JavaScript and TypeScript および Next.js のサポートに必要なプラグインが有効になっていることを確認します。詳細については、「プラグインのマッピング」を参照してください。

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

新しい Next.js アプリケーションの構築を開始するための推奨される方法は、PhpStorm が npx(英語) を使用してダウンロードして実行する create-next-app パッケージです。その結果、開発環境は Next.js を使用するように事前構成されています。

もちろん、自分で create-next-app をダウンロードすることも、空の PhpStorm プロジェクトを作成して Next.js をインストールすることもできます。

create-next-app で Next.js アプリケーションを生成する

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

  2. 左側のペインで、Next.js を選択します。

  3. 右側のペインで:

    1. プロジェクト関連ファイルが保存されるフォルダーへのパスを指定します。

    2. Node インタープリターフィールドに、使用する Node.js インタープリターを指定します。リストから設定済みのインタープリターを選択するか、追加を選択して新しいインタープリターを設定します。

    3. create-next-app リストから、npx create-next-app を選択します。

      または、npm バージョン 5.1 以前の場合、ターミナル Alt+F12npm install --save-dev next react react-dom を実行して、create-next-app パッケージを自分でインストールします。アプリケーションを作成するときに、create-next-app パッケージが保存されているフォルダーを選択します。

    4. オプション:

      JavaScript の代わりに TypeScript を使用するには、TypeScript テンプレートの使用チェックボックスを選択します。PhpStorm は、アプリケーション用の .ts ファイルと tsconfig.json 構成ファイルを生成します。

  4. 作成をクリックすると、PhpStorm は、必要なすべての構成ファイルを含む Next.js -specific プロジェクトを生成し、必要な依存関係をダウンロードします。PhpStorm は、アプリケーションを実行またはデバッグするためのデフォルト設定で、npm スタートおよび JavaScript デバッグ構成も作成します。

空の PhpStorm プロジェクトに Next.js をインストールする

この場合、ビルドパイプラインを自分で構成する必要があります。Next.js 公式サイト(英語)からプロジェクトに Next.js を追加する方法については、こちらを参照してください。

空の PhpStorm プロジェクトを作成する

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

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

空のプロジェクトに Next.js をインストールする

  1. Next.js を使用する空のプロジェクトを開きます。

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

    npm install --save-dev next react react-dom

既存の Next.js アプリケーションから開始する

既存の Next.js アプリケーションの開発を続けるには、それを PhpStorm で開き、必要な依存関係をダウンロードします。

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

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

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

  1. ウェルカム画面でリポジトリのクローンをクリックします。

    あるいは、メインメニューからファイル | 新規 | バージョン管理からプロジェクト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 のコンテキストメニューまたはプロジェクトツールウィンドウ Alt+1 から 'npm install' の実行または実行 'yarn install' を選択します。

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

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

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

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

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

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

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

プロジェクトのセキュリティの詳細を参照してください。

Next.js アプリケーションの実行とデバッグ

PhpStorm を使用すると、次の 2 つの方法でアプリケーションを実行し、デバッグセッションを開始できます。

  • エディターから - package.json またはターミナルから next dev コマンドをスクリプトとして実行します。その後、実行ツールウィンドウまたはターミナルでアプリケーション URL をクリックしてデバッグセッションを開始します。

  • 実行 / デバッグ構成の使用

エディターから実行とデバッグを開始する

Next Dev でアプリケーションを実行する

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

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

    実行ツールウィンドウまたはターミナルには、アプリケーションが実行されている URL が表示されます。デフォルトの URL は http://localhost:3000 です。

    Run tool window with a link to the app

    このリンクをクリックすると、ブラウザーでアプリケーションが表示されます。

実行ツールウィンドウまたはターミナルからデバッグセッションを開始する

  1. 必要に応じてブレークポイントの設定

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

  3. アプリケーションがコンパイルされ、開発サーバーの準備ができるまで待ちます。

    実行ツールウィンドウまたはターミナルには、アプリケーションが実行されている URL が表示されます。デフォルトの URL は http://localhost:3000 です。

    Start a debugging session from the Run tool window

    Ctrl+Shift を押しながらリンクをクリックします。

  4. アプリケーションがブラウザーで開いたら、プログラムの実行をトリガーするアクション(たとえば、リンクをクリックするなど)を実行します。フォーカスはデバッグツールウィンドウが開いた状態で PhpStorm に切り替わります。

    Debugging session started

    通常どおりに進めます。プログラムをステップ実行し、プログラムの実行を一時停止および再開し中断されたときにそれを調べ、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、実際の HTML DOM を表示するなどします。

実行 / デバッグ構成を使用して Next.js アプリケーションを実行およびデバッグする

ルート package.json に依存関係として next パッケージがリストされている単一リポジトリプロジェクトを開くと、PhpStorm によって 2 つの実行 / デバッグ構成が自動的に生成されます。

  • npm タイプの Next.js: server-side。この構成は、開発サーバーを起動し、アプリケーションを開発モードで実行する next dev コマンドを実行します。

  • ブラウザーでアプリケーションをデバッグするには、タイプ JavaScript デバッグNext.js: クライアント側のデバッグを使用します。

Two run/debug configurations are generated

実行 / デバッグ構成の作成

  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 アドレスを指定します。

    Browser / Live Edit tab: select browser

npm 実行 / デバッグ構成を使用して開発モードでアプリケーションを実行する

  1. ツールバーの実行ウィジェットのリストから、npm タイプの実行構成を選択します。これは、自動生成された Next.js: server-side 構成、または上記のように自分で作成したカスタム構成にすることができます。

    Run a Next.js app in the development mode via a run/debug configuration

    the Run icon をクリックします。

  2. アプリケーションがコンパイルされ、開発サーバーの準備が完了すると、実行ツールウィンドウにアプリケーションが実行されている URL が表示されます。デフォルトの URL は http://localhost:3000 ですが、デフォルトポート 3000 がすでに使用中の場合、サーバーは最も近い空きポートで起動を試みます。

    Running Next.js app in the development mode: the Development server is ready

    アプリケーションを表示するには、このリンクをクリックしてください。

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

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

  1. 必要に応じてブレークポイントの設定

  2. アプリケーションを開発モード npm 実行 / デバッグ構成または next devで実行します。

  3. アプリケーションがコンパイルされ、開発サーバーの準備が完了すると、実行ツールウィンドウにアプリケーションが実行されている URL が表示されます。デフォルトの URL は http://localhost:3000 ですが、デフォルトポート 3000 がすでに使用中の場合、サーバーは最も近い空きポートで起動を試みます。

  4. ツールバーの実行ウィジェットのリストから、JavaScript デバッグタイプの実行構成を選択します。これは、自動生成された Next.js: デバッグクライアント構成、または前述のように自分で作成したカスタム構成のいずれかになります。

    Start a debugging session — select the JavaScript Debug run configuration

    the Debug icon をクリックします。

  5. アプリケーションがブラウザーで開いたら、プログラムの実行をトリガーするアクション(たとえば、リンクをクリックするなど)を実行します。フォーカスはデバッグツールウィンドウが開いた状態で PhpStorm に切り替わります。

    通常どおりに進めます。プログラムをステップ実行し、プログラムの実行を一時停止および再開し中断されたときにそれを調べ、コールスタックと変数を調べ、ウォッチを設定し、変数を評価し、実際の HTML DOM を表示するなどします。

React アプリケーションを実行するおよび React アプリケーションをデバッグするを参照してください。

関連ページ:

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

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

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

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

npm、pnpm、Yarn

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

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

潜在的なセキュリティリスクを防ぐために、PhpStorm では、プロジェクトのソースがわからない場合に、プロジェクトの操作方法を決定できます。PhpStorm は、実行されるタスクまたは構成について警告し、信頼できるソースを構成できるようにします。不明なソースからプロジェクトを開く:プロジェクトを開くと、PhpStorm を使用すると、未知ソースコードを含むプロジェクトの処理方法をすぐに決定できます。プロジェクトを初めて開くたびに、IDE にプロジェクトを信頼ダイアログが表示されます。これは、...

NPM ツールウィンドウ

ツールウィンドウを npm、pnpm、Yarn スクリプトを実行するに使用します。始める前に:Node.js をダウンロードしてインストールします。npm もインストールされることに注意してください。使用する場合は、事前の手順は完了しています。Yarn を使用するには、Yarn オフィシャル Web サイトの説明に従ってインストールしてください。スクリプトの実行:プロジェクトツールウィンドウで package.json ファイルを選択するか、エディターで開いてコンテキストメニューから npm スクリ...

ブレークポイント

ブレークポイントは、特定のポイントでプログラムの実行を一時停止する特別なマーカーです。これにより、プログラムの状態と動作を調べることができます。ブレークポイントは、たとえば、特定のコード行に到達したときにプログラムを一時停止するなどの単純なものから、追加の条件をチェックしたり、ログに書き込んだりするなどのより複雑なロジックを含むものまであります。ブレークポイントは、一度設定すると、一時的なブレークポイントを除き、明示的に削除するまでプロジェクト内に残ります。ブレークポイントの種類:PhpSto